@electrum-cash/network 4.3.0 → 4.3.1-development.16658117881

package/dist/index.d.mts

@@ -285,6 +285,15 @@ declare class ElectrumClient<ElectrumEvents extends ElectrumClientEvents> extend
    * @returns a promise that resolves with the result of the method or an Error.
    */
   request(method: string, ...parameters: RPCParameter[]): Promise<Error | RequestResponse>;
+  /**
+   * Settles a pending request with an error, for instance when its message could not be sent.
+   *
+   * @param id    - the id of the request to settle.
+   * @param error - the reason the request failed.
+   *
+   * @ignore
+   */
+  private abortRequest;
   /**
    * Subscribes to the method and payload at the server.
    *

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../source/enums.ts","../source/rpc-interfaces.ts","../source/interfaces.ts","../source/electrum-client.ts"],"mappings":";;;;;;;;;;;;oBASY;EAEX;EACA;EACA;EACA;EACA;;;;YCdW;YAGA;iBAGK;EAEhB;;iBAIgB,wBAAwB;EAExC;EACA,SAAS;;iBAIO,mBAAmB;EAEnC,IAAI;EACJ;EACA,SAAS;;iBAIO,qBAAqB;EAErC,IAAI;EACJ;;iBAGgB;EAEhB;EACA;EACA;;iBAIgB,yBAAyB;EAEzC,IAAI;EACJ,OAAO;;YAII,cAAc,mBAAmB,eAAe;YAGhD,aAAa,kBAAkB,aAAa;YAG5C,mBAAmB;YACnB,kBAAkB;qBAEjB,qBAAkB,SAAqB,YAAU,WAAW;qBAK5D,iBAAc,SAAqB,YAAU,WAAW;qBAKxD,oBAAiB,SAAqB,YAAU,WAAW;qBAK3D,eAAY,SAAqB,YAAU,WAAW;;;;;;iBCnElD,+BAA+B,QAAQ;;EAGvD;;EAGA;;EAGA;;EAGA;;;;;iBAMgB;EAEhB,OAAO;;;;;iBAMS;EAEhB;EACA;;;;;YAMW,6BAA6B,oBAAoB;;;;;;iBAO5C;;;;;EAMhB;;;;;EAMA,aAAc;;;;;EAMd,YAAa;;;;;EAMb;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA,UAAW;;;;;;;iBAQK;;;;;EAMhB,iBAAkB;;;;;EAMlB;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA,UAAW;;;;;;YAOA,kBAAkB,eAAe;;;;;;YAOjC,mBAAmB,QAAQ,OAAO;;;;;YAMlC,gBAAgB,MAAM,OAAO,IAAI,YAAY;;;;;YAM7C,kBAAkB;;;;qBAKjB,oBAAiB,QAAoB,+BAA6B,UAAU;;;;qBAQ5E,sBAAmB,QAAoB,+BAA6B,UAAU;;;;;;cChLrF,eAAe,uBAAuB,8BAA8B,aAAa,uBAAuB,2BAA2B;EA0DhI;EACA;EACA,kBAAkB;EAClB,SAAS,QAAQ;;;;EAxDlB;;;;;EAMA;;;;;EAMA;;;;EAKA;;;;MAKI,UAAU;UAMb;UAGA;UAGA;UAGA;UAGA;;;;;;;;;;;EAaA,YAAA,qBACA,iBACA,kBAAkB,yBAClB,UAAS,QAAQ;MAcrB;MAMA;;;;;;;EAWE,WAAW;;;;;;;;;EA2CX,WAAW,iBAAwB,gCAAuC;;;;;;;;;;EA4B1E,QAAQ,mBAAmB,YAAY,iBAAiB,QAAQ,QAAQ;;;;;;;;;;;;EA2DxE,UAAU,mBAAmB,YAAY,iBAAiB;;;;;;;;;;;;EAqD1D,YAAY,mBAAmB,YAAY,iBAAiB;;;;;;;;;;UA6CpD;;;;;;;;;EA2Cd,SAAS,SAAS;;;;;;;EAgEZ,0BAA0B;;;;;;EAwB1B,qBAAqB,wBAAmB;;;;;;EAkBxC,+BAA+B;;;;;;;EAY/B,0CAA0C,eAAU;;;;;;;EAgBpD,qCAAqC,eAAU;;;;EAoB/C,8BAA8B,iBAAY;WAOhC;WACA;WACA;WACA;WACA;WACA,eAAgB;WAChB,QAAS"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../source/enums.ts","../source/rpc-interfaces.ts","../source/interfaces.ts","../source/electrum-client.ts"],"mappings":";;;;;;;;;;;;oBASY;EAEX;EACA;EACA;EACA;EACA;;;;YCdW;YAGA;iBAGK;EAEhB;;iBAIgB,wBAAwB;EAExC;EACA,SAAS;;iBAIO,mBAAmB;EAEnC,IAAI;EACJ;EACA,SAAS;;iBAIO,qBAAqB;EAErC,IAAI;EACJ;;iBAGgB;EAEhB;EACA;EACA;;iBAIgB,yBAAyB;EAEzC,IAAI;EACJ,OAAO;;YAII,cAAc,mBAAmB,eAAe;YAGhD,aAAa,kBAAkB,aAAa;YAG5C,mBAAmB;YACnB,kBAAkB;qBAEjB,qBAAkB,SAAqB,YAAU,WAAW;qBAK5D,iBAAc,SAAqB,YAAU,WAAW;qBAKxD,oBAAiB,SAAqB,YAAU,WAAW;qBAK3D,eAAY,SAAqB,YAAU,WAAW;;;;;;iBCnElD,+BAA+B,QAAQ;;EAGvD;;EAGA;;EAGA;;EAGA;;;;;iBAMgB;EAEhB,OAAO;;;;;iBAMS;EAEhB;EACA;;;;;YAMW,6BAA6B,oBAAoB;;;;;;iBAO5C;;;;;EAMhB;;;;;EAMA,aAAc;;;;;EAMd,YAAa;;;;;EAMb;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA,UAAW;;;;;;;iBAQK;;;;;EAMhB,iBAAkB;;;;;EAMlB;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA;;;;;EAMA,UAAW;;;;;;YAOA,kBAAkB,eAAe;;;;;;YAOjC,mBAAmB,QAAQ,OAAO;;;;;YAMlC,gBAAgB,MAAM,OAAO,IAAI,YAAY;;;;;YAM7C,kBAAkB;;;;qBAKjB,oBAAiB,QAAoB,+BAA6B,UAAU;;;;qBAQ5E,sBAAmB,QAAoB,+BAA6B,UAAU;;;;;;cChLrF,eAAe,uBAAuB,8BAA8B,aAAa,uBAAuB,2BAA2B;EA0DhI;EACA;EACA,kBAAkB;EAClB,SAAS,QAAQ;;;;EAxDlB;;;;;EAMA;;;;;EAMA;;;;EAKA;;;;MAKI,UAAU;UAMb;UAGA;UAGA;UAGA;UAGA;;;;;;;;;;;EAaA,YAAA,qBACA,iBACA,kBAAkB,yBAClB,UAAS,QAAQ;MAcrB;MAMA;;;;;;;EAWE,WAAW;;;;;;;;;EA2CX,WAAW,iBAAwB,gCAAuC;;;;;;;;;;EA4B1E,QAAQ,mBAAmB,YAAY,iBAAiB,QAAQ,QAAQ;;;;;;;;;UAoEtE;;;;;;;;;;;;EA6BF,UAAU,mBAAmB,YAAY,iBAAiB;;;;;;;;;;;;EAqD1D,YAAY,mBAAmB,YAAY,iBAAiB;;;;;;;;;;UA6CpD;;;;;;;;;EA2Cd,SAAS,SAAS;;;;;;;EAgEZ,0BAA0B;;;;;;EAwB1B,qBAAqB,wBAAmB;;;;;;EAkBxC,+BAA+B;;;;;;;EAY/B,0CAA0C,eAAU;;;;;;;EAgBpD,qCAAqC,eAAU;;;;EAoB/C,8BAA8B,iBAAY;WAOhC;WACA;WACA;WACA;WACA;WACA,eAAgB;WAChB,QAAS"}

package/dist/index.mjs

@@ -188,7 +188,11 @@ var ElectrumConnection = class extends EventEmitter {
 	async ping() {
 		debug.ping(`Sending keep-alive ping to '${this.hostIdentifier}'`);
 		const message = ElectrumProtocol.buildRequestObject("server.ping", [], "keepAlive");
-		return this.send(message);
+		try {
+			return await this.send(message);
+		} catch (_ignored) {
+			return false;
+		}
 	}
 	/**
 	* Initiates the network connection negotiates a protocol version. Also emits the 'connect' signal if successful.
@@ -200,18 +204,32 @@ var ElectrumConnection = class extends EventEmitter {
 		if (this.status === 1) return;
 		this.status = 3;
 		this.emit("connecting");
-		const connectionResolver = (resolve, reject) => {
-			this.once("connected", () => {
-				this.removeListener("disconnected", reject);
-				resolve();
-			});
-			this.once("disconnected", () => {
-				this.removeListener("connected", resolve);
-				reject();
-			});
-			this.socket.connect();
+		let resolveConnection;
+		let rejectConnection;
+		const connectionPromise = new Promise((resolve, reject) => {
+			resolveConnection = resolve;
+			rejectConnection = reject;
+		});
+		const onConnected = () => {
+			resolveConnection();
 		};
-		await new Promise(connectionResolver);
+		let socketError;
+		const onDisconnected = () => {
+			rejectConnection(socketError ?? /* @__PURE__ */ new Error(`Failed to connect to '${this.hostIdentifier}'.`));
+		};
+		this.once("connected", onConnected);
+		this.once("disconnected", onDisconnected);
+		try {
+			await this.socket.connect();
+		} catch (error) {
+			socketError = error;
+		}
+		try {
+			await connectionPromise;
+		} finally {
+			this.removeListener("connected", onConnected);
+			this.removeListener("disconnected", onDisconnected);
+		}
 	}
 	/**
 	* Restores the network connection.
@@ -221,7 +239,7 @@ var ElectrumConnection = class extends EventEmitter {
 		debug.network(`Trying to reconnect to '${this.hostIdentifier}'..`);
 		this.status = 4;
 		this.emit("reconnecting");
-		this.socket.disconnect();
+		this.closeSocket();
 		try {
 			await this.connect();
 		} catch (_error) {}
@@ -261,8 +279,13 @@ var ElectrumConnection = class extends EventEmitter {
 		await this.clearKeepAliveTimer();
 		await this.clearReconnectTimer();
 		const disconnectResolver = (resolve) => {
+			if (this.socket.isDisconnected) {
+				this.onSocketDisconnect();
+				resolve(true);
+				return;
+			}
 			this.once("disconnected", () => resolve(true));
-			this.socket.disconnect();
+			this.closeSocket();
 		};
 		return new Promise(disconnectResolver);
 	}
@@ -283,6 +306,20 @@ var ElectrumConnection = class extends EventEmitter {
 		return this.socket.write(message + ElectrumProtocol.statementDelimiter);
 	}
 	/**
+	* Closes the underlying socket.
+	*
+	* @remarks The socket reports the closed connection through its 'disconnected' event, which is what drives
+	*          our connection state. Any promise returned by the socket is consumed here so that a failure to
+	*          close cannot surface as an unhandled rejection.
+	*/
+	async closeSocket() {
+		try {
+			await this.socket.disconnect();
+		} catch (error) {
+			debug.warning(`Failed to close the socket for '${this.hostIdentifier}': `, error);
+		}
+	}
+	/**
 	* Marks the connection as timed out and schedules reconnection if we have not
 	* received data within the expected time frame.
 	*/
@@ -291,7 +328,7 @@ var ElectrumConnection = class extends EventEmitter {
 			if (this.status === 0 || this.status === 2) return;
 			this.clearKeepAliveTimer();
 			debug.network(`Connection to '${this.hostIdentifier}' timed out.`);
-			this.socket.disconnect();
+			this.closeSocket();
 		}
 	}
 	/**
@@ -301,7 +338,12 @@ var ElectrumConnection = class extends EventEmitter {
 		this.clearReconnectTimer();
 		this.lastReceivedTimestamp = Date.now();
 		this.setupKeepAliveTimer();
-		await new Promise(this.negotiateVersion.bind(this));
+		try {
+			await this.negotiateVersion();
+		} catch (error) {
+			debug.errors(`Aborted connection with '${this.hostIdentifier}': `, error);
+			return;
+		}
 		this.emit("connected");
 	}
 	/**
@@ -330,39 +372,51 @@ var ElectrumConnection = class extends EventEmitter {
 		debug.errors(`Network error ('${this.hostIdentifier}'): `, error);
 	}
 	/**
-	* Negotiate the protocol version with the server.
-	* Disconnect the connection if the version negotiation fails.
-	* @param resolve 
-	* @param reject 
+	* Negotiates the protocol version with the server, and disconnects if the negotiation fails.
+	*
+	* @throws {Error} if the server rejects or negotiates an incompatible protocol version, or the connection is lost.
+	* @returns a promise resolving when the protocol version has been negotiated.
 	*/
-	async negotiateVersion(resolve, reject) {
+	async negotiateVersion() {
+		let resolveNegotiation;
+		let rejectNegotiation;
+		const negotiationPromise = new Promise((resolve, reject) => {
+			resolveNegotiation = resolve;
+			rejectNegotiation = reject;
+		});
 		const rejector = () => {
-			this.status = 0;
-			this.emit("disconnected");
-			reject(`Version negotiation with ${this.hostIdentifier} failed.`);
+			rejectNegotiation(/* @__PURE__ */ new Error(`Version negotiation with '${this.hostIdentifier}' failed due to lost connection.`));
 		};
-		debug.network(`Requesting protocol version ${this.version} with '${this.hostIdentifier}'.`);
-		this.socket.once("disconnected", rejector);
-		const versionMessage = ElectrumProtocol.buildRequestObject("server.version", [this.application, this.version], "versionNegotiation");
 		const versionValidator = (version) => {
 			if (isVersionRejected(version)) {
 				this.disconnect(true);
 				const errorMessage = "unsupported protocol version.";
 				debug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);
-				reject(errorMessage);
+				rejectNegotiation(/* @__PURE__ */ new Error(errorMessage));
 			} else if (version.protocol !== this.version && `${version.protocol}.0` !== this.version && `${version.protocol}.0.0` !== this.version) {
 				this.disconnect(true);
 				const errorMessage = `incompatible protocol version negotiated (${version.protocol} !== ${this.version}).`;
 				debug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);
-				reject(errorMessage);
+				rejectNegotiation(new Error(errorMessage));
 			} else {
 				debug.network(`Negotiated protocol version ${version.protocol} with '${this.hostIdentifier}', powered by ${version.software}.`);
 				this.status = 1;
-				resolve();
+				resolveNegotiation();
 			}
 		};
+		debug.network(`Requesting protocol version ${this.version} with '${this.hostIdentifier}'.`);
+		this.socket.once("disconnected", rejector);
 		this.once("version", versionValidator);
-		this.send(versionMessage);
+		const versionMessage = ElectrumProtocol.buildRequestObject("server.version", [this.application, this.version], "versionNegotiation");
+		try {
+			await this.send(versionMessage);
+		} catch (_ignored) {}
+		try {
+			await negotiationPromise;
+		} finally {
+			this.socket.removeListener("disconnected", rejector);
+			this.removeListener("version", versionValidator);
+		}
 	}
 };
 //#endregion
@@ -501,10 +555,29 @@ var ElectrumClient = class extends EventEmitter {
 				if (error) resolve(error);
 				else resolve(data);
 			};
-			this.connection.send(message);
 		};
+		const responsePromise = new Promise(requestResolver);
 		debug.network(`Sending request '${method}' to '${this.hostIdentifier}'`);
-		return new Promise(requestResolver);
+		try {
+			await this.connection.send(message);
+		} catch (error) {
+			this.abortRequest(id, error);
+		}
+		return responsePromise;
+	}
+	/**
+	* Settles a pending request with an error, for instance when its message could not be sent.
+	*
+	* @param id    - the id of the request to settle.
+	* @param error - the reason the request failed.
+	*
+	* @ignore
+	*/
+	abortRequest(id, error) {
+		const requestResolver = this.requestResolvers[id];
+		if (!requestResolver) return;
+		delete this.requestResolvers[id];
+		requestResolver(error instanceof Error ? error : new Error(String(error)));
 	}
 	/**
 	* Subscribes to the method and payload at the server.

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../source/electrum-protocol.ts","../source/rpc-interfaces.ts","../source/enums.ts","../source/interfaces.ts","../source/electrum-connection.ts","../source/constants.ts","../source/electrum-client.ts"],"sourcesContent":["import type { RPCParameter } from './rpc-interfaces.ts';\n\n/**\n * Grouping of utilities that simplifies implementation of the Electrum protocol.\n *\n * @ignore\n */\nexport class ElectrumProtocol\n{\n\t/**\n\t * Helper function that builds an Electrum request object.\n\t *\n\t * @param method     - method to call.\n\t * @param parameters - method parameters for the call.\n\t * @param requestId  - unique string or number referencing this request.\n\t *\n\t * @returns a properly formatted Electrum request string.\n\t */\n\tstatic buildRequestObject(method: string, parameters: RPCParameter[], requestId: string | number): string\n\t{\n\t\t// Return the formatted request object.\n\t\t// NOTE: Electrum either uses JsonRPC strictly or loosely.\n\t\t//       If we specify protocol identifier without being 100% compliant, we risk being disconnected/blacklisted.\n\t\t//       For this reason, we omit the protocol identifier to avoid issues.\n\t\treturn JSON.stringify({ method: method, params: parameters, id: requestId });\n\t}\n\n\t/**\n\t * Constant used to verify if a provided string is a valid version number.\n\t *\n\t * @returns a regular expression that matches valid version numbers.\n\t */\n\tstatic get versionRegexp(): RegExp\n\t{\n\t\treturn /^\\d+(\\.\\d+)+$/;\n\t}\n\n\t/**\n\t * Constant used to separate statements/messages in a stream of data.\n\t *\n\t * @returns the delimiter used by Electrum to separate statements.\n\t */\n\tstatic get statementDelimiter(): string\n\t{\n\t\treturn '\\n';\n\t}\n}\n","// Acceptable parameter types for RPC messages\nexport type RPCParameter = string | number | boolean | object | null;\n\n// Acceptable identifier types for RCP messages.\nexport type RCPIdentifier = number | string | null;\n\n// The base type for all RPC messages\nexport interface RPCBase\n{\n\tjsonrpc: string;\n}\n\n// An RPC message that sends a notification requiring no response\nexport interface RPCNotification extends RPCBase\n{\n\tmethod: string;\n\tparams?: RPCParameter[];\n}\n\n// An RPC message that sends a request requiring a response\nexport interface RPCRequest extends RPCBase\n{\n\tid: RCPIdentifier;\n\tmethod: string;\n\tparams?: RPCParameter[];\n}\n\n// An RPC message that returns the response to a successful request\nexport interface RPCStatement extends RPCBase\n{\n\tid: RCPIdentifier;\n\tresult: string;\n}\n\nexport interface RPCError\n{\n\tcode: number;\n\tmessage: string;\n\tdata?: unknown;\n}\n\n// An RPC message that returns the error to an unsuccessful request\nexport interface RPCErrorResponse extends RPCBase\n{\n\tid: RCPIdentifier;\n\terror: RPCError;\n}\n\n// A response to a request is either a statement (successful) or an error (unsuccessful)\nexport type RPCResponse = RPCErrorResponse | RPCStatement | RPCNotification;\n\n// RPC messages are notifications, requests, or responses\nexport type RPCMessage = RPCNotification | RPCRequest | RPCResponse;\n\n// Requests and responses can also be sent in batches\nexport type RPCResponseBatch = RPCResponse[];\nexport type RPCRequestBatch = RPCRequest[];\n\nexport const isRPCErrorResponse = function(message: RPCBase): message is RPCErrorResponse\n{\n\treturn 'id' in message && 'error' in message;\n};\n\nexport const isRPCStatement = function(message: RPCBase): message is RPCStatement\n{\n\treturn 'id' in message && 'result' in message;\n};\n\nexport const isRPCNotification = function(message: RPCBase): message is RPCNotification\n{\n\treturn !('id' in message) && 'method' in message;\n};\n\nexport const isRPCRequest = function(message: RPCBase): message is RPCRequest\n{\n\treturn 'id' in message && 'method' in message;\n};\n","/**\n * Enum that denotes the connection status of an ElectrumConnection.\n * @enum {number}\n * @property {0} DISCONNECTED    The connection is disconnected.\n * @property {1} AVAILABLE       The connection is connected.\n * @property {2} DISCONNECTING   The connection is disconnecting.\n * @property {3} CONNECTING      The connection is connecting.\n * @property {4} RECONNECTING    The connection is restarting.\n */\nexport enum ConnectionStatus\n{\n\tDISCONNECTED = 0,\n\tCONNECTED = 1,\n\tDISCONNECTING = 2,\n\tCONNECTING = 3,\n\tRECONNECTING = 4,\n}\n","import type { RPCError, RPCParameter, RPCResponse, RPCNotification } from './rpc-interfaces';\nimport type { ElectrumSocketOptions } from '@electrum-cash/socket';\n\n/**\n * Optional settings that change the default behavior of the network connection.\n */\nexport interface ElectrumNetworkOptions extends Partial<ElectrumSocketOptions>\n{\n\t/** If set to true, numbers that can safely be parsed as integers will be `BigInt` rather than `Number`. */\n\tuseBigInt?: boolean;\n\n\t/** When connected, send a keep-alive Ping message this often. */\n\tsendKeepAliveIntervalInMilliSeconds?: number;\n\n\t/** When disconnected, attempt to reconnect after this amount of time. */\n\treconnectAfterMilliSeconds?: number;\n\n\t/** After every send, verify that we have received data after this amount of time. */\n\tverifyConnectionTimeoutInMilliSeconds?: number;\n}\n\n/**\n * @ignore\n */\nexport interface VersionRejected\n{\n\terror: RPCError;\n}\n\n/**\n * @ignore\n */\nexport interface VersionNegotiated\n{\n\tsoftware: string;\n\tprotocol: string;\n}\n\n/**\n * @ignore\n */\nexport type VersionNegotiationResponse = VersionNegotiated | VersionRejected;\n\n/**\n * List of events emitted by the ElectrumConnection.\n * @event\n * @ignore\n */\nexport interface ElectrumConnectionEvents\n{\n\t/**\n\t * Emitted when any data has been received over the network.\n\t * @eventProperty\n\t */\n\t'received': [];\n\n\t/**\n\t * Emitted when a complete electrum message has been received over the network.\n\t * @eventProperty\n\t */\n\t'response': [ RPCResponse ];\n\n\t/**\n\t * Emitted when the connection has completed version negotiation.\n\t * @eventProperty\n\t */\n\t'version': [ VersionNegotiationResponse ];\n\n\t/**\n\t * Emitted when a network connection is initiated.\n\t * @eventProperty\n\t */\n\t'connecting': [];\n\n\t/**\n\t * Emitted when a network connection is successful.\n\t * @eventProperty\n\t */\n\t'connected': [];\n\n\t/**\n\t * Emitted when a network disconnection is initiated.\n\t * @eventProperty\n\t */\n\t'disconnecting': [];\n\n\t/**\n\t * Emitted when a network disconnection is successful.\n\t * @eventProperty\n\t */\n\t'disconnected': [];\n\n\t/**\n\t * Emitted when a network connect attempts to automatically reconnect.\n\t * @eventProperty\n\t */\n\t'reconnecting': [];\n\n\t/**\n\t * Emitted when the network has failed in some way.\n\t * @eventProperty\n\t */\n\t'error': [ Error ];\n}\n\n/**\n * List of events emitted by the ElectrumClient.\n * @event\n * @ignore\n */\nexport interface ElectrumClientEvents\n{\n\t/**\n\t * Emitted when an electrum subscription statement has been received over the network.\n\t * @eventProperty\n\t */\n\t'notification': [ RPCNotification ];\n\n\t/**\n\t * Emitted when a network connection is initiated.\n\t * @eventProperty\n\t */\n\t'connecting': [];\n\n\t/**\n\t * Emitted when a network connection is successful.\n\t * @eventProperty\n\t */\n\t'connected': [];\n\n\t/**\n\t * Emitted when a network disconnection is initiated.\n\t * @eventProperty\n\t */\n\t'disconnecting': [];\n\n\t/**\n\t * Emitted when a network disconnection is successful.\n\t * @eventProperty\n\t */\n\t'disconnected': [];\n\n\t/**\n\t * Emitted when a network connect attempts to automatically reconnect.\n\t * @eventProperty\n\t */\n\t'reconnecting': [];\n\n\t/**\n\t * Emitted when the network has failed in some way.\n\t * @eventProperty\n\t */\n\t'error': [ Error ];\n}\n\n/**\n * A list of possible responses to requests.\n * @ignore\n */\nexport type RequestResponse = RPCParameter | RPCParameter[];\n\n/**\n * Request resolvers are used to process the response of a request. This takes either\n * an error object or any stringified data, while the other parameter is omitted.\n * @ignore\n */\nexport type RequestResolver = (error?: Error, data?: string) => void;\n\n/**\n * Typing for promise resolution.\n * @ignore\n */\nexport type ResolveFunction<T> = (value: T | PromiseLike<T>) => void;\n\n/**\n * Typing for promise rejection.\n * @ignore\n */\nexport type RejectFunction = (reason?: unknown) => void;\n\n/**\n * @ignore\n */\nexport const isVersionRejected = function(object: VersionNegotiationResponse): object is VersionRejected\n{\n\treturn 'error' in object;\n};\n\n/**\n * @ignore\n */\nexport const isVersionNegotiated = function(object: VersionNegotiationResponse): object is VersionNegotiated\n{\n\treturn 'software' in object && 'protocol' in object;\n};\n","import debug from '@electrum-cash/debug-logs';\nimport { ElectrumWebSocket } from '@electrum-cash/web-socket';\nimport { ElectrumProtocol } from './electrum-protocol.ts';\nimport { isRPCNotification, isRPCErrorResponse } from './rpc-interfaces.ts';\nimport { EventEmitter } from 'eventemitter3';\nimport { ConnectionStatus } from './enums.ts';\nimport { parse, parseNumberAndBigInt } from 'lossless-json';\nimport { isVersionRejected } from './interfaces.ts';\nimport type { ElectrumNetworkOptions, ElectrumConnectionEvents, ResolveFunction, RejectFunction, VersionNegotiationResponse } from './interfaces.ts';\nimport type { RPCResponse } from './rpc-interfaces.ts';\nimport type { ElectrumSocket } from '@electrum-cash/socket';\n\n/**\n * Wrapper around TLS/WSS sockets that gracefully separates a network stream into Electrum protocol messages.\n */\nexport class ElectrumConnection extends EventEmitter<ElectrumConnectionEvents>\n{\n\t// Initialize the connected flag to false to indicate that there is no connection\n\tpublic status: ConnectionStatus = ConnectionStatus.DISCONNECTED;\n\n\t// Declare empty timestamps\n\tprivate lastReceivedTimestamp: number;\n\n\t// Declare an empty socket.\n\tprivate socket: ElectrumSocket;\n\n\t// Declare timers for keep-alive pings and reconnection\n\tprivate keepAliveTimer?: number;\n\tprivate reconnectTimer?: number;\n\n\t// Initialize an empty array of connection verification timers.\n\tprivate verifications: Array<number> = [];\n\n\t// Initialize messageBuffer to an empty string\n\tprivate messageBuffer = '';\n\n\t/**\n\t * Sets up network configuration for an Electrum client connection.\n\t *\n\t * @param application       - your application name, used to identify to the electrum host.\n\t * @param version           - protocol version to use with the host.\n\t * @param socketOrHostname  - pre-configured electrum socket or fully qualified domain name or IP number of the host\n\t * @param options           - ...\n\t *\n\t * @throws {Error} if `version` is not a valid version string.\n\t */\n\tconstructor(\n\t\tprivate application: string,\n\t\tprivate version: string,\n\t\tprivate socketOrHostname: ElectrumSocket | string,\n\t\tprivate options: ElectrumNetworkOptions,\n\t)\n\t{\n\t\t// Initialize the event emitter.\n\t\tsuper();\n\n\t\t// Check if the provided version is a valid version number.\n\t\tif(!ElectrumProtocol.versionRegexp.test(version))\n\t\t{\n\t\t\t// Throw an error since the version number was not valid.\n\t\t\tthrow(new Error(`Provided version string (${version}) is not a valid protocol version number.`));\n\t\t}\n\n\t\t// If a hostname was provided..\n\t\tif(typeof socketOrHostname === 'string')\n\t\t{\n\t\t\t// Use a web socket with default parameters.\n\t\t\tthis.socket = new ElectrumWebSocket(socketOrHostname, this.options);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Use the provided socket.\n\t\t\tthis.socket = socketOrHostname;\n\t\t}\n\n\t\t// Set up handlers for connection and disconnection.\n\t\tthis.socket.on('connected', this.onSocketConnect.bind(this));\n\t\tthis.socket.on('disconnected', this.onSocketDisconnect.bind(this));\n\n\t\t// Set up handler for incoming data.\n\t\tthis.socket.on('data', this.parseMessageChunk.bind(this));\n\t}\n\n\t// Expose hostIdentifier from the socket.\n\tget hostIdentifier(): string\n\t{\n\t\treturn this.socket.host;\n\t}\n\n\t// Expose port from the socket.\n\tget encrypted(): boolean\n\t{\n\t\treturn this.socket.options.encrypted;\n\t}\n\n\t/**\n\t * Assembles incoming data into statements and hands them off to the message parser.\n\t *\n\t * @param data - data to append to the current message buffer, as a string.\n\t *\n\t * @throws {SyntaxError} if the passed statement parts are not valid JSON.\n\t */\n\tparseMessageChunk(data: string): void\n\t{\n\t\t// Update the timestamp for when we last received data.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\n\t\t// Emit a notification indicating that the connection has received data.\n\t\tthis.emit('received');\n\n\t\t// Clear and remove all verification timers.\n\t\tthis.verifications.forEach((timer) => clearTimeout(timer));\n\t\tthis.verifications.length = 0;\n\n\t\t// Add the message to the current message buffer.\n\t\tthis.messageBuffer += data;\n\n\t\t// Check if the new message buffer contains the statement delimiter.\n\t\twhile(this.messageBuffer.includes(ElectrumProtocol.statementDelimiter))\n\t\t{\n\t\t\t// Split message buffer into statements.\n\t\t\tconst statementParts = this.messageBuffer.split(ElectrumProtocol.statementDelimiter);\n\n\t\t\t// For as long as we still have statements to parse..\n\t\t\twhile(statementParts.length > 1)\n\t\t\t{\n\t\t\t\t// Move the first statement to its own variable.\n\t\t\t\tconst currentStatementList = String(statementParts.shift());\n\n\t\t\t\t// Parse the statement into an object or list of objects.\n\t\t\t\tlet statementList = parse(currentStatementList, null, this.options.useBigInt ? parseNumberAndBigInt : parseFloat) as RPCResponse | RPCResponse[];\n\n\t\t\t\t// Wrap the statement in an array if it is not already a batched statement list.\n\t\t\t\tif(!Array.isArray(statementList))\n\t\t\t\t{\n\t\t\t\t\tstatementList = [ statementList ];\n\t\t\t\t}\n\n\t\t\t\t// For as long as there is statements in the result set..\n\t\t\t\twhile(statementList.length > 0)\n\t\t\t\t{\n\t\t\t\t\t// Move the first statement from the batch to its own variable.\n\t\t\t\t\tconst currentStatement = statementList.shift();\n\n\t\t\t\t\t// If the current statement is a subscription notification..\n\t\t\t\t\tif(isRPCNotification(currentStatement))\n\t\t\t\t\t{\n\t\t\t\t\t\t// Emit the notification for handling higher up in the stack.\n\t\t\t\t\t\tthis.emit('response', currentStatement);\n\n\t\t\t\t\t\t// Consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// If the current statement is a version negotiation response..\n\t\t\t\t\tif(currentStatement.id === 'versionNegotiation')\n\t\t\t\t\t{\n\t\t\t\t\t\tif(isRPCErrorResponse(currentStatement))\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Then emit a failed version negotiation response signal.\n\t\t\t\t\t\t\tthis.emit('version', { error: currentStatement.error });\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Extract the software and protocol version reported.\n\t\t\t\t\t\t\tconst [ software, protocol ] = currentStatement.result;\n\n\t\t\t\t\t\t\t// Emit a successful version negotiation response signal.\n\t\t\t\t\t\t\tthis.emit('version', { software, protocol });\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// If the current statement is a keep-alive response..\n\t\t\t\t\tif(currentStatement.id === 'keepAlive')\n\t\t\t\t\t{\n\t\t\t\t\t\t// Do nothing and consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Emit the statements for handling higher up in the stack.\n\t\t\t\t\tthis.emit('response', currentStatement);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Store the remaining statement as the current message buffer.\n\t\t\tthis.messageBuffer = statementParts.shift() || '';\n\t\t}\n\t}\n\n\t/**\n\t * Sends a keep-alive message to the host.\n\t *\n\t * @returns true if the ping message was fully flushed to the socket, false if\n\t * part of the message is queued in the user memory\n\t */\n\tasync ping(): Promise<boolean>\n\t{\n\t\t// Write a log message.\n\t\tdebug.ping(`Sending keep-alive ping to '${this.hostIdentifier}'`);\n\n\t\t// Craft a keep-alive message.\n\t\tconst message = ElectrumProtocol.buildRequestObject('server.ping', [], 'keepAlive');\n\n\t\t// Send the keep-alive message.\n\t\tconst status = this.send(message);\n\n\t\t// Return the ping status.\n\t\treturn status;\n\t}\n\n\t/**\n\t * Initiates the network connection negotiates a protocol version. Also emits the 'connect' signal if successful.\n\t *\n\t * @throws {Error} if the socket connection fails.\n\t * @returns a promise resolving when the connection is established\n\t */\n\tasync connect(): Promise<void>\n\t{\n\t\t// If we are already connected return true.\n\t\tif(this.status === ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Indicate that the connection is connecting\n\t\tthis.status = ConnectionStatus.CONNECTING;\n\n\t\t// Emit a connect event now that the connection is being set up.\n\t\tthis.emit('connecting');\n\n\t\t// Create a function that will resolve once the connection is established.\n\t\t// The connection is established through onSocketConnect\n\t\tconst connectionResolver = (resolve: ResolveFunction<void>, reject: RejectFunction): void =>\n\t\t{\n\t\t\t// Resolve the connection promise once the connection is established. This event is emitted by onSocketConnect.\n\t\t\tthis.once('connected', () =>\n\t\t\t{\n\t\t\t\t// Remove the listener for the disconnected event.\n\t\t\t\tthis.removeListener('disconnected', reject);\n\n\t\t\t\t// Resolve the connection promise.\n\t\t\t\tresolve();\n\t\t\t});\n\n\t\t\t// Reject the connection promise if the connection is disconnected.\n\t\t\tthis.once('disconnected', () =>\n\t\t\t{\n\t\t\t\t// Remove the listener for the connected event.\n\t\t\t\tthis.removeListener('connected', resolve);\n\n\t\t\t\t// Reject the connection promise.\n\t\t\t\treject();\n\t\t\t});\n\n\t\t\t// Start the socket connection process.\n\t\t\tthis.socket.connect();\n\t\t};\n\n\t\t// Wait until connection is established and version negotiation succeeds.\n\t\tawait new Promise<void>(connectionResolver);\n\t}\n\n\t/**\n\t * Restores the network connection.\n\t */\n\tasync reconnect(): Promise<void>\n\t{\n\t\t// If a reconnect timer is set, remove it\n\t\tawait this.clearReconnectTimer();\n\n\t\t// Write a log message.\n\t\tdebug.network(`Trying to reconnect to '${this.hostIdentifier}'..`);\n\n\t\t// Set the status to reconnecting for more accurate log messages.\n\t\tthis.status = ConnectionStatus.RECONNECTING;\n\n\t\t// Emit a connect event now that the connection is usable.\n\t\tthis.emit('reconnecting');\n\n\t\t// Disconnect the underlying socket\n\t\tthis.socket.disconnect();\n\n\t\ttry\n\t\t{\n\t\t\t// Try to connect again.\n\t\t\tawait this.connect();\n\t\t}\n\t\tcatch (_error)\n\t\t{\n\t\t\t// Do nothing as the error should be handled via the disconnect and error signals.\n\t\t}\n\t}\n\n\t/**\n\t * Removes the current reconnect timer.\n\t */\n\tclearReconnectTimer(): void\n\t{\n\t\t// If a reconnect timer is set, remove it\n\t\tif(this.reconnectTimer)\n\t\t{\n\t\t\tclearTimeout(this.reconnectTimer);\n\t\t}\n\n\t\t// Reset the timer reference.\n\t\tthis.reconnectTimer = undefined;\n\t}\n\n\t/**\n\t * Removes the current keep-alive timer.\n\t */\n\tclearKeepAliveTimer(): void\n\t{\n\t\t// If a keep-alive timer is set, remove it\n\t\tif(this.keepAliveTimer)\n\t\t{\n\t\t\tclearTimeout(this.keepAliveTimer);\n\t\t}\n\n\t\t// Reset the timer reference.\n\t\tthis.keepAliveTimer = undefined;\n\t}\n\n\t/**\n\t * Initializes the keep alive timer loop.\n\t */\n\tsetupKeepAliveTimer(): void\n\t{\n\t\t// If the keep-alive timer loop is not currently set up..\n\t\tif(!this.keepAliveTimer)\n\t\t{\n\t\t\t// Set a new keep-alive timer.\n\t\t\tthis.keepAliveTimer = setTimeout(this.ping.bind(this), this.options.sendKeepAliveIntervalInMilliSeconds) as unknown as number;\n\t\t}\n\t}\n\n\t/**\n\t * Tears down the current connection and removes all event listeners on disconnect.\n\t *\n\t * @param force       - disconnect even if the connection has not been fully established yet.\n\t * @param intentional - update connection state if disconnect is intentional.\n\t *\n\t * @returns true if successfully disconnected, or false if there was no connection.\n\t */\n\tasync disconnect(force: boolean = false, intentional: boolean = true): Promise<boolean>\n\t{\n\t\t// Return early when there is nothing to disconnect from\n\t\tif(this.status === ConnectionStatus.DISCONNECTED && !force)\n\t\t{\n\t\t\t// Return false to indicate that there was nothing to disconnect from.\n\t\t\treturn false;\n\t\t}\n\n\t\t// Update connection state if the disconnection is intentional.\n\t\t// NOTE: The state is meant to represent what the client is requesting, but\n\t\t//       is used internally to handle visibility changes in browsers to ensure functional reconnection.\n\t\tif(intentional)\n\t\t{\n\t\t\t// Set connection status to null to indicate tear-down is currently happening.\n\t\t\tthis.status = ConnectionStatus.DISCONNECTING;\n\t\t}\n\n\t\t// Emit a connect event to indicate that we are disconnecting.\n\t\tthis.emit('disconnecting');\n\n\t\t// If a keep-alive timer is set, remove it.\n\t\tawait this.clearKeepAliveTimer();\n\n\t\t// If a reconnect timer is set, remove it\n\t\tawait this.clearReconnectTimer();\n\n\t\tconst disconnectResolver = (resolve: ResolveFunction<boolean>): void =>\n\t\t{\n\t\t\t// Resolve to true after the connection emits a disconnect\n\t\t\tthis.once('disconnected', () => resolve(true));\n\n\t\t\t// Close the connection on the socket level.\n\t\t\tthis.socket.disconnect();\n\t\t};\n\n\t\t// Return true to indicate that we disconnected.\n\t\treturn new Promise<boolean>(disconnectResolver);\n\t}\n\n\t/**\n\t * Sends an arbitrary message to the server.\n\t *\n\t * @param message - json encoded request object to send to the server, as a string.\n\t *\n\t * @returns true if the message was fully flushed to the socket, false if part of the message\n\t * is queued in the user memory\n\t */\n\tasync send(message: string): Promise<boolean>\n\t{\n\t\t// Remove the current keep-alive timer if it exists.\n\t\tthis.clearKeepAliveTimer();\n\n\t\t// Get the current timestamp in milliseconds.\n\t\tconst currentTime = Date.now();\n\n\t\t// Follow up and verify that the message got sent..\n\t\tconst verificationTimer = setTimeout(this.verifySend.bind(this, currentTime), this.socket.options.timeoutInMilliSeconds) as unknown as number;\n\n\t\t// Store the verification timer locally so that it can be cleared when data has been received.\n\t\tthis.verifications.push(verificationTimer);\n\n\t\t// Set a new keep-alive timer.\n\t\tthis.setupKeepAliveTimer();\n\n\t\t// Write the message to the network socket.\n\t\treturn this.socket.write(message + ElectrumProtocol.statementDelimiter);\n\t}\n\n\t// --- Event managers. --- //\n\n\t/**\n\t * Marks the connection as timed out and schedules reconnection if we have not\n\t * received data within the expected time frame.\n\t */\n\tverifySend(sentTimestamp: number): void\n\t{\n\t\t// If we haven't received any data since we last sent data out..\n\t\tif(Number(this.lastReceivedTimestamp) < sentTimestamp)\n\t\t{\n\t\t\t// If this connection is already disconnected, we do not change anything\n\t\t\tif((this.status === ConnectionStatus.DISCONNECTED) || (this.status === ConnectionStatus.DISCONNECTING))\n\t\t\t{\n\t\t\t\t// debug.warning(`Tried to verify already disconnected connection to '${this.hostIdentifier}'`);\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Remove the current keep-alive timer if it exists.\n\t\t\tthis.clearKeepAliveTimer();\n\n\t\t\t// Write a notification to the logs.\n\t\t\tdebug.network(`Connection to '${this.hostIdentifier}' timed out.`);\n\n\t\t\t// Close the connection to avoid re-use.\n\t\t\t// NOTE: This initiates reconnection routines if the connection has not\n\t\t\t//       been marked as intentionally disconnected.\n\t\t\tthis.socket.disconnect();\n\t\t}\n\t}\n\n\t/**\n\t * Updates the connection status when a connection is confirmed.\n\t */\n\tasync onSocketConnect(): Promise<void>\n\t{\n\t\t// If a reconnect timer is set, remove it.\n\t\tthis.clearReconnectTimer();\n\n\t\t// Set up the initial timestamp for when we last received data from the server.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\n\t\t// Set up the initial keep-alive timer.\n\t\tthis.setupKeepAliveTimer();\n\t\t\n\t\t// Wait for the version to be negotiated.\n\t\tawait new Promise<void>(this.negotiateVersion.bind(this));\n\n\t\t// Emit a connect event now that the connection is established and version negotiated.\n\t\tthis.emit('connected');\n\t}\n\n\t/**\n\t * Updates the connection status when a connection is ended.\n\t */\n\tonSocketDisconnect(): void\n\t{\n\t\t// Remove the current keep-alive timer if it exists.\n\t\tthis.clearKeepAliveTimer();\n\n\t\t// If this is a connection we're trying to tear down..\n\t\tif(this.status === ConnectionStatus.DISCONNECTING)\n\t\t{\n\t\t\t// Mark the connection as disconnected.\n\t\t\tthis.status = ConnectionStatus.DISCONNECTED;\n\n\t\t\t// Send a disconnect signal higher up the stack.\n\t\t\tthis.emit('disconnected');\n\n\t\t\t// If a reconnect timer is set, remove it.\n\t\t\tthis.clearReconnectTimer();\n\n\t\t\t// Remove all event listeners\n\t\t\tthis.removeAllListeners();\n\n\t\t\t// Write a log message.\n\t\t\tdebug.network(`Disconnected from '${this.hostIdentifier}'.`);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// If this is for an established connection..\n\t\t\tif(this.status === ConnectionStatus.CONNECTED)\n\t\t\t{\n\t\t\t\t// Write a notification to the logs.\n\t\t\t\tdebug.errors(`Connection with '${this.hostIdentifier}' was closed, trying to reconnect in ${this.options.reconnectAfterMilliSeconds / 1000} seconds.`);\n\t\t\t}\n\t\t\t// If this is a connection that is currently connecting, reconnecting or already disconnected..\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Do nothing\n\n\t\t\t\t// NOTE: This error message is useful during manual debugging of reconnections.\n\t\t\t\t// debug.errors(`Lost connection with reconnecting or already disconnected server '${this.hostIdentifier}'.`);\n\t\t\t}\n\n\t\t\t// Mark the connection as disconnected for now..\n\t\t\tthis.status = ConnectionStatus.DISCONNECTED;\n\n\t\t\t// Send a disconnect signal higher up the stack.\n\t\t\tthis.emit('disconnected');\n\n\t\t\t// If we don't have a pending reconnection timer..\n\t\t\tif(!this.reconnectTimer)\n\t\t\t{\n\t\t\t\t// Attempt to reconnect after one keep-alive duration.\n\t\t\t\tthis.reconnectTimer = setTimeout(this.reconnect.bind(this), this.options.reconnectAfterMilliSeconds) as unknown as number;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Notify administrator of any unexpected errors.\n\t */\n\tonSocketError(error: unknown | undefined): void\n\t{\n\t\t// Report a generic error if no error information is present.\n\t\t// NOTE: When using WSS, the error event explicitly\n\t\t//       only allows to send a \"simple\" event without data.\n\t\t//       https://stackoverflow.com/a/18804298\n\t\tif(typeof error === 'undefined')\n\t\t{\n\t\t\t// Do nothing, and instead rely on the socket disconnect event for further information.\n\t\t\treturn;\n\t\t}\n\n\t\t// Log the error, as there is nothing we can do to actually handle it.\n\t\tdebug.errors(`Network error ('${this.hostIdentifier}'): `, error);\n\t}\n\n\t/**\n\t * Negotiate the protocol version with the server.\n\t * Disconnect the connection if the version negotiation fails.\n\t * @param resolve \n\t * @param reject \n\t */\n\tasync negotiateVersion(resolve: ResolveFunction<void>, reject: RejectFunction): Promise<void>\n\t{\n\t\tconst rejector = (): void =>\n\t\t{\n\t\t\t// Set the status back to disconnected\n\t\t\tthis.status = ConnectionStatus.DISCONNECTED;\n\n\t\t\t// Emit a connect event indicating that we failed to connect.\n\t\t\tthis.emit('disconnected');\n\n\t\t\t// Reject with the error as reason\n\t\t\treject(`Version negotiation with ${this.hostIdentifier} failed.`);\n\t\t};\n\n\t\t// Write a log message to show that we have started version negotiation.\n\t\tdebug.network(`Requesting protocol version ${this.version} with '${this.hostIdentifier}'.`);\n\t\t\t\t\n\t\t// Add error handler for one-time error.\n\t\tthis.socket.once('disconnected', rejector);\n\n\t\t// Build a version negotiation message.\n\t\tconst versionMessage = ElectrumProtocol.buildRequestObject('server.version', [ this.application, this.version ], 'versionNegotiation');\n\n\t\t// Define a function to wrap version validation as a function.\n\t\tconst versionValidator = (version: VersionNegotiationResponse): void =>\n\t\t{\n\t\t\t// Check if version negotiation failed.\n\t\t\tif(isVersionRejected(version))\n\t\t\t{\n\t\t\t\t// Disconnect from the host.\n\t\t\t\tthis.disconnect(true);\n\n\t\t\t\t// Declare an error message.\n\t\t\t\tconst errorMessage = 'unsupported protocol version.';\n\n\t\t\t\t// Log the error.\n\t\t\t\tdebug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);\n\n\t\t\t\t// Reject the connection with false since version negotiation failed.\n\t\t\t\treject(errorMessage);\n\t\t\t}\n\t\t\t// Check if the host supports our requested protocol version.\n\t\t\t// NOTE: the server responds with version numbers that truncate 0's, so 1.5.0 turns into 1.5.\n\t\t\telse if((version.protocol !== this.version) && (`${version.protocol}.0` !== this.version) && (`${version.protocol}.0.0` !== this.version))\n\t\t\t{\n\t\t\t\t// Disconnect from the host.\n\t\t\t\tthis.disconnect(true);\n\n\t\t\t\t// Declare an error message.\n\t\t\t\tconst errorMessage = `incompatible protocol version negotiated (${version.protocol} !== ${this.version}).`;\n\n\t\t\t\t// Log the error.\n\t\t\t\tdebug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);\n\n\t\t\t\t// Reject the connection with false since version negotiation failed.\n\t\t\t\treject(errorMessage);\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Write a log message.\n\t\t\t\tdebug.network(`Negotiated protocol version ${version.protocol} with '${this.hostIdentifier}', powered by ${version.software}.`);\n\n\t\t\t\t// Set connection status to connected\n\t\t\t\tthis.status = ConnectionStatus.CONNECTED;\n\n\t\t\t\t// Resolve the connection promise since we successfully connected and negotiated protocol version.\n\t\t\t\tresolve();\n\t\t\t}\n\t\t};\n\n\t\t// Listen for version negotiation once.\n\t\tthis.once('version', versionValidator);\n\n\t\t// Send the version negotiation message.\n\t\tthis.send(versionMessage);\n\t}\n}\n","import type { ElectrumNetworkOptions } from './interfaces.ts';\n\n// Define number of milliseconds per second for legibility.\nconst MILLI_SECONDS_PER_SECOND = 1000;\n\n/**\n * Configure default options.\n */\nexport const defaultNetworkOptions: ElectrumNetworkOptions =\n{\n\t// By default, all numbers including integers are parsed as regular JavaScript numbers.\n\tuseBigInt: false,\n\n\t// Send a ping message every seconds, to detect network problem as early as possible.\n\tsendKeepAliveIntervalInMilliSeconds: 1 * MILLI_SECONDS_PER_SECOND,\n\n\t// Try to reconnect 5 seconds after unintentional disconnects.\n\treconnectAfterMilliSeconds: 5 * MILLI_SECONDS_PER_SECOND,\n\n\t// Try to detect stale connections 5 seconds after every send.\n\tverifyConnectionTimeoutInMilliSeconds: 5 * MILLI_SECONDS_PER_SECOND,\n};\n","import debug from '@electrum-cash/debug-logs';\nimport { ElectrumConnection } from './electrum-connection.ts';\nimport { ElectrumProtocol } from './electrum-protocol.ts';\nimport { defaultNetworkOptions } from './constants.ts';\nimport { ConnectionStatus } from './enums.ts';\nimport { EventEmitter } from 'eventemitter3';\nimport { Mutex } from 'async-mutex';\nimport { isRPCNotification, isRPCErrorResponse } from './rpc-interfaces.ts';\nimport type { RPCParameter, RPCNotification, RPCResponse } from './rpc-interfaces.ts';\nimport type { ElectrumNetworkOptions, ElectrumClientEvents, ResolveFunction, RequestResolver, RequestResponse } from './interfaces.ts';\nimport type { ElectrumSocket } from '@electrum-cash/socket';\n\n/**\n * High-level Electrum client that lets applications send requests and subscribe to notification events from a server.\n */\nclass ElectrumClient<ElectrumEvents extends ElectrumClientEvents> extends EventEmitter<ElectrumClientEvents | ElectrumEvents> implements ElectrumClientEvents\n{\n\t/**\n\t * The name and version of the server software indexing the blockchain.\n\t */\n\tpublic software: string;\n\n\t/**\n\t * The genesis hash of the blockchain indexed by the server.\n\t * @remarks This is only available after a 'server.features' call.\n\t */\n\tpublic genesisHash: string;\n\n\t/**\n\t * The chain height of the blockchain indexed by the server.\n\t * @remarks This is only available after a 'blockchain.headers.subscribe' call.\n\t */\n\tpublic chainHeight: number;\n\n\t/**\n\t * Timestamp of when we last received data from the server indexing the blockchain.\n\t */\n\tpublic lastReceivedTimestamp: number;\n\n\t/**\n\t * Number corresponding to the underlying connection status.\n\t */\n\tpublic get status(): ConnectionStatus\n\t{\n\t\treturn this.connection.status;\n\t}\n\n\t// Declare instance variables\n\tprivate connection: ElectrumConnection;\n\n\t// Initialize an empty list of subscription metadata.\n\tprivate subscriptionMethods: Record<string, Set<string>> = {};\n\n\t// Start counting the request IDs from 0\n\tprivate requestId = 0;\n\n\t// Initialize an empty dictionary for keeping track of request resolvers\n\tprivate requestResolvers: { [index: number]: RequestResolver } = {};\n\n\t// Mutex lock used to prevent simultaneous connect() and disconnect() calls.\n\tprivate connectionLock = new Mutex();\n\n\t/**\n\t * Initializes an Electrum client.\n\t *\n\t * @param application       - your application name, used to identify to the electrum host.\n\t * @param version           - protocol version to use with the host.\n\t * @param socketOrHostname  - pre-configured electrum socket or fully qualified domain name or IP number of the host\n\t * @param options           - ...\n\t *\n\t * @throws {Error} if `version` is not a valid version string.\n\t */\n\tconstructor(\n\t\tpublic application: string,\n\t\tpublic version: string,\n\t\tpublic socketOrHostname: ElectrumSocket | string,\n\t\tpublic options: Partial<ElectrumNetworkOptions> = {},\n\t)\n\t{\n\t\t// Initialize the event emitter.\n\t\tsuper();\n\n\t\t// Update default options with the provided values.\n\t\tconst networkOptions: ElectrumNetworkOptions = { ...defaultNetworkOptions, ...options };\n\n\t\t// Set up a connection to an electrum server.\n\t\tthis.connection = new ElectrumConnection(application, version, socketOrHostname, networkOptions);\n\t}\n\n\t// Expose hostIdentifier from the connection.\n\tget hostIdentifier(): string\n\t{\n\t\treturn this.connection.hostIdentifier;\n\t}\n\n\t// Expose port from the connection.\n\tget encrypted(): boolean\n\t{\n\t\treturn this.connection.encrypted;\n\t}\n\n\t/**\n\t * Connects to the remote server.\n\t *\n\t * @throws {Error} if the socket connection fails.\n\t * @returns a promise resolving when the connection is established.\n\t */\n\tasync connect(): Promise<void>\n\t{\n\t\t// Force concurrent calls to this function to be run serially.\n\t\treturn this.connectionLock.runExclusive(async () =>\n\t\t{\n\t\t\t// If we are already connected, do not attempt to connect again.\n\t\t\tif(this.connection.status === ConnectionStatus.CONNECTED)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Listen for parsed statements.\n\t\t\tthis.connection.on('response', this.response.bind(this));\n\n\t\t\t// Hook up handles for the connected and disconnected events.\n\t\t\tthis.connection.on('connected', this.resubscribeOnConnect.bind(this));\n\t\t\tthis.connection.on('disconnected', this.onConnectionDisconnect.bind(this));\n\n\t\t\t// Relay connecting and reconnecting events.\n\t\t\tthis.connection.on('connecting', this.handleConnectionStatusChanges.bind(this, 'connecting'));\n\t\t\tthis.connection.on('disconnecting', this.handleConnectionStatusChanges.bind(this, 'disconnecting'));\n\t\t\tthis.connection.on('reconnecting', this.handleConnectionStatusChanges.bind(this, 'reconnecting'));\n\n\t\t\t// Hook up client metadata gathering functions.\n\t\t\tthis.connection.on('version', this.storeSoftwareVersion.bind(this));\n\t\t\tthis.connection.on('received', this.updateLastReceivedTimestamp.bind(this));\n\n\t\t\t// Relay error events.\n\t\t\tthis.connection.on('error', this.emit.bind(this, 'error'));\n\n\t\t\t// Connect with the server.\n\t\t\tawait this.connection.connect();\n\t\t});\n\t}\n\n\t/**\n\t * Disconnects from the remote server and removes all event listeners/subscriptions and open requests.\n\t *\n\t * @param force               - disconnect even if the connection has not been fully established yet.\n\t * @param retainSubscriptions - retain subscription data so they will be restored on reconnection.\n\t *\n\t * @returns true if successfully disconnected, or false if there was no connection.\n\t */\n\tasync disconnect(force: boolean = false, retainSubscriptions: boolean = false): Promise<boolean>\n\t{\n\t\t// Force concurrent calls to this function to be run serially.\n\t\treturn this.connectionLock.runExclusive(async () =>\n\t\t{\n\t\t\tif(!retainSubscriptions)\n\t\t\t{\n\t\t\t\t// Cancel all event listeners.\n\t\t\t\tthis.removeAllListeners();\n\n\t\t\t\t// Remove all subscription data\n\t\t\t\tthis.subscriptionMethods = {};\n\t\t\t}\n\n\t\t\t// Disconnect from the remote server.\n\t\t\treturn this.connection.disconnect(force);\n\t\t});\n\t}\n\n\t/**\n\t * Calls a method on the remote server with the supplied parameters.\n\t *\n\t * @param method     - name of the method to call.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise that resolves with the result of the method or an Error.\n\t */\n\tasync request(method: string, ...parameters: RPCParameter[]): Promise<Error | RequestResponse>\n\t{\n\t\t// If we are not connected to a server..\n\t\tif(this.connection.status !== ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\t// Reject the request with a disconnected error message.\n\t\t\tthrow(new Error(`Unable to send request to a disconnected server '${this.hostIdentifier}'.`));\n\t\t}\n\n\t\t// Increase the request ID by one.\n\t\tthis.requestId += 1;\n\n\t\t// Store a copy of the request id.\n\t\tconst id = this.requestId;\n\n\t\t// Format the arguments as an electrum request object.\n\t\tconst message = ElectrumProtocol.buildRequestObject(method, parameters, id);\n\n\t\t// Define a function to wrap the request in a promise.\n\t\tconst requestResolver = (resolve: ResolveFunction<Error | RequestResponse>): void =>\n\t\t{\n\t\t\t// Add a request resolver for this promise to the list of requests.\n\t\t\tthis.requestResolvers[id] = (error?: Error, data?: RequestResponse) =>\n\t\t\t{\n\t\t\t\t// If the resolution failed..\n\t\t\t\tif(error)\n\t\t\t\t{\n\t\t\t\t\t// Resolve the promise with the error for the application to handle.\n\t\t\t\t\tresolve(error);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// Resolve the promise with the request results.\n\t\t\t\t\tresolve(data);\n\t\t\t\t}\n\t\t\t};\n\n\t\t\t// Send the request message to the remote server.\n\t\t\tthis.connection.send(message);\n\t\t};\n\n\t\t// Write a log message.\n\t\tdebug.network(`Sending request '${method}' to '${this.hostIdentifier}'`);\n\n\t\t// return a promise to deliver results later.\n\t\treturn new Promise<Error | RequestResponse>(requestResolver);\n\t}\n\n\t/**\n\t * Subscribes to the method and payload at the server.\n\t *\n\t * @remarks the response for the subscription request is issued as a notification event.\n\t *\n\t * @param method     - one of the subscribable methods the server supports.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving when the subscription is established.\n\t */\n\tasync subscribe(method: string, ...parameters: RPCParameter[]): Promise<void>\n\t{\n\t\t// Initialize an empty list of subscription payloads, if needed.\n\t\tif(!this.subscriptionMethods[method])\n\t\t{\n\t\t\tthis.subscriptionMethods[method] = new Set<string>();\n\t\t}\n\n\t\t// Store the subscription parameters to track what data we have subscribed to.\n\t\tthis.subscriptionMethods[method].add(JSON.stringify(parameters));\n\n\t\t// Send initial subscription request.\n\t\tconst requestData = await this.request(method, ...parameters);\n\n\t\t// If the request failed, throw it as an error.\n\t\tif(requestData instanceof Error)\n\t\t{\n\t\t\tthrow(requestData);\n\t\t}\n\n\t\t// If the request returned more than one data point..\n\t\tif(Array.isArray(requestData))\n\t\t{\n\t\t\t// .. throw an error, as this breaks our expectation for subscriptions.\n\t\t\tthrow(new Error('Subscription request returned an more than one data point.'));\n\t\t}\n\n\t\t// Construct a notification structure to package the initial result as a notification.\n\t\tconst notification: RPCNotification =\n\t\t{\n\t\t\tjsonrpc: '2.0',\n\t\t\tmethod: method,\n\t\t\tparams: [ ...parameters, requestData ],\n\t\t};\n\n\t\t// Manually emit an event for the initial response.\n\t\tthis.emit('notification', notification);\n\n\t\t// Try to update the chain height.\n\t\tthis.updateChainHeightFromHeadersNotifications(notification);\n\t}\n\n\t/**\n\t * Unsubscribes to the method at the server and removes any callback functions\n\t * when there are no more subscriptions for the method.\n\t *\n\t * @param method     - a previously subscribed to method.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if no subscriptions exist for the combination of the provided `method` and `parameters.\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving when the subscription is removed.\n\t */\n\tasync unsubscribe(method: string, ...parameters: RPCParameter[]): Promise<void>\n\t{\n\t\t// Throw an error if the client is disconnected.\n\t\tif(this.connection.status !== ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\tthrow(new Error(`Unable to send unsubscribe request to a disconnected server '${this.hostIdentifier}'.`));\n\t\t}\n\n\t\t// If this method has no subscriptions..\n\t\tif(!this.subscriptionMethods[method])\n\t\t{\n\t\t\t// Reject this promise with an explanation.\n\t\t\tthrow(new Error(`Cannot unsubscribe from '${method}' since the method has no subscriptions.`));\n\t\t}\n\n\t\t// Pack up the parameters as a long string.\n\t\tconst subscriptionParameters = JSON.stringify(parameters);\n\n\t\t// If the method payload could not be located..\n\t\tif(!this.subscriptionMethods[method].has(subscriptionParameters))\n\t\t{\n\t\t\t// Reject this promise with an explanation.\n\t\t\tthrow(new Error(`Cannot unsubscribe from '${method}' since it has no subscription with the given parameters.`));\n\t\t}\n\n\t\t// Remove this specific subscription payload from internal tracking.\n\t\tthis.subscriptionMethods[method].delete(subscriptionParameters);\n\n\t\t// Send unsubscription request to the server\n\t\t// NOTE: As a convenience we allow users to define the method as the subscribe or unsubscribe version.\n\t\tawait this.request(method.replace('.subscribe', '.unsubscribe'), ...parameters);\n\n\t\t// Write a log message.\n\t\tdebug.client(`Unsubscribed from '${String(method)}' for the '${subscriptionParameters}' parameters.`);\n\t}\n\n\t/**\n\t * Restores existing subscriptions without updating status or triggering manual callbacks.\n\t *\n\t * @throws {Error} if subscription data cannot be found for all stored event names.\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving to true when the subscriptions are restored.\n\t *\n\t * @ignore\n\t */\n\tprivate async resubscribeOnConnect(): Promise<void>\n\t{\n\t\t// Write a log message.\n\t\tdebug.client(`Connected to '${this.hostIdentifier}'.`);\n\n\t\t// Synchronize with the underlying connection status.\n\t\tthis.handleConnectionStatusChanges('connected');\n\n\t\t// Initialize an empty list of resubscription promises.\n\t\tconst resubscriptionPromises = [];\n\n\t\t// For each method we have a subscription for..\n\t\tfor(const method in this.subscriptionMethods)\n\t\t{\n\t\t\t// .. and for each parameter we have previously been subscribed to..\n\t\t\tfor(const parameterJSON of this.subscriptionMethods[method].values())\n\t\t\t{\n\t\t\t\t// restore the parameters from JSON.\n\t\t\t\tconst parameters = JSON.parse(parameterJSON);\n\n\t\t\t\t// Send a subscription request.\n\t\t\t\tresubscriptionPromises.push(this.subscribe(method, ...parameters));\n\t\t\t}\n\n\t\t\t// Wait for all re-subscriptions to complete.\n\t\t\tawait Promise.all(resubscriptionPromises);\n\t\t}\n\n\t\t// Write a log message if there was any subscriptions to restore.\n\t\tif(resubscriptionPromises.length > 0)\n\t\t{\n\t\t\tdebug.client(`Restored ${resubscriptionPromises.length} previous subscriptions for '${this.hostIdentifier}'`);\n\t\t}\n\t}\n\n\t/**\n\t * Parser messages from the remote server to resolve request promises and emit subscription events.\n\t *\n\t * @param message - the response message\n\t *\n\t * @throws {Error} if the message ID does not match an existing request.\n\t * @ignore\n\t */\n\tresponse(message: RPCResponse): void\n\t{\n\t\t// If the received message is a notification, we forward it to all event listeners\n\t\tif(isRPCNotification(message))\n\t\t{\n\t\t\t// Write a log message.\n\t\t\tdebug.client(`Received notification for '${message.method}' from '${this.hostIdentifier}'`);\n\n\t\t\t// Forward the message content to all event listeners.\n\t\t\tthis.emit('notification', message);\n\n\t\t\t// Try to update the chain height.\n\t\t\tthis.updateChainHeightFromHeadersNotifications(message);\n\n\t\t\t// Return since it does not have an associated request resolver\n\t\t\treturn;\n\t\t}\n\n\t\t// If the response ID is null we cannot use it to index our request resolvers\n\t\tif(message.id === null)\n\t\t{\n\t\t\t// Throw an internal error, this should not happen.\n\t\t\tthrow(new Error('Internal error: Received an RPC response with ID null.'));\n\t\t}\n\n\t\t// Look up which request promise we should resolve this.\n\t\tconst requestResolver = this.requestResolvers[message.id];\n\n\t\t// If we do not have a request resolver for this response message..\n\t\tif(!requestResolver)\n\t\t{\n\t\t\t// Log that a message was ignored since the request has already been rejected.\n\t\t\tdebug.warning(`Ignoring response #${message.id} as the request has already been rejected.`);\n\n\t\t\t// Return as this has now been fully handled.\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove the promise from the request list.\n\t\tdelete this.requestResolvers[message.id];\n\n\t\t// If the message contains an error..\n\t\tif(isRPCErrorResponse(message))\n\t\t{\n\t\t\t// Forward the message error to the request resolver and omit the `result` parameter.\n\t\t\trequestResolver(new Error(message.error.message));\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Forward the message content to the request resolver and omit the `error` parameter\n\t\t\t// (by setting it to undefined).\n\t\t\trequestResolver(undefined, message.result);\n\n\t\t\t// Attempt to extract genesis hash from feature requests.\n\t\t\tthis.storeGenesisHashFromFeaturesResponse(message);\n\t\t}\n\t}\n\n\t/**\n\t * Callback function that is called when connection to the Electrum server is lost.\n\t * Aborts all active requests with an error message indicating that connection was lost.\n\t *\n\t * @ignore\n\t */\n\tasync onConnectionDisconnect(): Promise<void>\n\t{\n\t\t// Loop over active requests\n\t\tfor(const resolverId in this.requestResolvers)\n\t\t{\n\t\t\t// Extract request resolver for readability\n\t\t\tconst requestResolver = this.requestResolvers[resolverId];\n\n\t\t\t// Resolve the active request with an error indicating that the connection was lost.\n\t\t\trequestResolver(new Error('Connection lost'));\n\n\t\t\t// Remove the promise from the request list.\n\t\t\tdelete this.requestResolvers[resolverId];\n\t\t}\n\n\t\t// Synchronize with the underlying connection status.\n\t\tthis.handleConnectionStatusChanges('disconnected');\n\t}\n\n\t/**\n\t * Stores the server provider software version field on successful version negotiation.\n\t *\n\t * @ignore\n\t */\n\tasync storeSoftwareVersion(versionStatement): Promise<void>\n\t{\n\t\t// TODO: handle failed version negotiation better.\n\t\tif(versionStatement.error)\n\t\t{\n\t\t\t// Do nothing.\n\t\t\treturn;\n\t\t}\n\n\t\t// Store the software version.\n\t\tthis.software = versionStatement.software;\n\t}\n\n\t/**\n\t * Updates the last received timestamp.\n\t *\n\t * @ignore\n\t */\n\tasync updateLastReceivedTimestamp(): Promise<void>\n\t{\n\t\t// Update the timestamp for when we last received data.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\t}\n\n\t/**\n\t * Checks if the provided message is a response to a headers subscription,\n\t * and if so updates the locally stored chain height value for this client.\n\t *\n\t * @ignore\n\t */\n\tasync updateChainHeightFromHeadersNotifications(message): Promise<void>\n\t{\n\t\t// If the message is a notification for a new chain height..\n\t\tif(message.method === 'blockchain.headers.subscribe')\n\t\t{\n\t\t\t// ..also store the updated chain height locally.\n\t\t\tthis.chainHeight = message.params[0].height;\n\t\t}\n\t}\n\n\t/**\n\t * Checks if the provided message is a response to a server.features request,\n\t * and if so stores the genesis hash for this client locally.\n\t *\n\t * @ignore\n\t */\n\tasync storeGenesisHashFromFeaturesResponse(message): Promise<void>\n\t{\n\t\ttry\n\t\t{\n\t\t\t// If the message is a response to a features request..\n\t\t\tif(typeof message.result.genesis_hash !== 'undefined')\n\t\t\t{\n\t\t\t\t// ..store the genesis hash locally.\n\t\t\t\tthis.genesisHash = message.result.genesis_hash;\n\t\t\t}\n\t\t}\n\t\tcatch (_ignored)\n\t\t{\n\t\t\t// Do nothing.\n\t\t}\n\t}\n\n\t/**\n\t * Helper function to synchronize state and events with the underlying connection.\n\t */\n\tasync handleConnectionStatusChanges(eventName): Promise<void>\n\t{\n\t\t// Re-emit the event.\n\t\tthis.emit(eventName);\n\t}\n\n\t// Add magic glue that makes typedoc happy so that we can have the events listed on the class.\n\tpublic readonly connecting: [];\n\tpublic readonly connected: [];\n\tpublic readonly disconnecting: [];\n\tpublic readonly disconnected: [];\n\tpublic readonly reconnecting: [];\n\tpublic readonly notification: [ RPCNotification ];\n\tpublic readonly error: [ Error ];\n}\n\n// Export the client.\nexport default ElectrumClient;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../source/electrum-protocol.ts","../source/rpc-interfaces.ts","../source/enums.ts","../source/interfaces.ts","../source/electrum-connection.ts","../source/constants.ts","../source/electrum-client.ts"],"sourcesContent":["import type { RPCParameter } from './rpc-interfaces.ts';\n\n/**\n * Grouping of utilities that simplifies implementation of the Electrum protocol.\n *\n * @ignore\n */\nexport class ElectrumProtocol\n{\n\t/**\n\t * Helper function that builds an Electrum request object.\n\t *\n\t * @param method     - method to call.\n\t * @param parameters - method parameters for the call.\n\t * @param requestId  - unique string or number referencing this request.\n\t *\n\t * @returns a properly formatted Electrum request string.\n\t */\n\tstatic buildRequestObject(method: string, parameters: RPCParameter[], requestId: string | number): string\n\t{\n\t\t// Return the formatted request object.\n\t\t// NOTE: Electrum either uses JsonRPC strictly or loosely.\n\t\t//       If we specify protocol identifier without being 100% compliant, we risk being disconnected/blacklisted.\n\t\t//       For this reason, we omit the protocol identifier to avoid issues.\n\t\treturn JSON.stringify({ method: method, params: parameters, id: requestId });\n\t}\n\n\t/**\n\t * Constant used to verify if a provided string is a valid version number.\n\t *\n\t * @returns a regular expression that matches valid version numbers.\n\t */\n\tstatic get versionRegexp(): RegExp\n\t{\n\t\treturn /^\\d+(\\.\\d+)+$/;\n\t}\n\n\t/**\n\t * Constant used to separate statements/messages in a stream of data.\n\t *\n\t * @returns the delimiter used by Electrum to separate statements.\n\t */\n\tstatic get statementDelimiter(): string\n\t{\n\t\treturn '\\n';\n\t}\n}\n","// Acceptable parameter types for RPC messages\nexport type RPCParameter = string | number | boolean | object | null;\n\n// Acceptable identifier types for RCP messages.\nexport type RCPIdentifier = number | string | null;\n\n// The base type for all RPC messages\nexport interface RPCBase\n{\n\tjsonrpc: string;\n}\n\n// An RPC message that sends a notification requiring no response\nexport interface RPCNotification extends RPCBase\n{\n\tmethod: string;\n\tparams?: RPCParameter[];\n}\n\n// An RPC message that sends a request requiring a response\nexport interface RPCRequest extends RPCBase\n{\n\tid: RCPIdentifier;\n\tmethod: string;\n\tparams?: RPCParameter[];\n}\n\n// An RPC message that returns the response to a successful request\nexport interface RPCStatement extends RPCBase\n{\n\tid: RCPIdentifier;\n\tresult: string;\n}\n\nexport interface RPCError\n{\n\tcode: number;\n\tmessage: string;\n\tdata?: unknown;\n}\n\n// An RPC message that returns the error to an unsuccessful request\nexport interface RPCErrorResponse extends RPCBase\n{\n\tid: RCPIdentifier;\n\terror: RPCError;\n}\n\n// A response to a request is either a statement (successful) or an error (unsuccessful)\nexport type RPCResponse = RPCErrorResponse | RPCStatement | RPCNotification;\n\n// RPC messages are notifications, requests, or responses\nexport type RPCMessage = RPCNotification | RPCRequest | RPCResponse;\n\n// Requests and responses can also be sent in batches\nexport type RPCResponseBatch = RPCResponse[];\nexport type RPCRequestBatch = RPCRequest[];\n\nexport const isRPCErrorResponse = function(message: RPCBase): message is RPCErrorResponse\n{\n\treturn 'id' in message && 'error' in message;\n};\n\nexport const isRPCStatement = function(message: RPCBase): message is RPCStatement\n{\n\treturn 'id' in message && 'result' in message;\n};\n\nexport const isRPCNotification = function(message: RPCBase): message is RPCNotification\n{\n\treturn !('id' in message) && 'method' in message;\n};\n\nexport const isRPCRequest = function(message: RPCBase): message is RPCRequest\n{\n\treturn 'id' in message && 'method' in message;\n};\n","/**\n * Enum that denotes the connection status of an ElectrumConnection.\n * @enum {number}\n * @property {0} DISCONNECTED    The connection is disconnected.\n * @property {1} AVAILABLE       The connection is connected.\n * @property {2} DISCONNECTING   The connection is disconnecting.\n * @property {3} CONNECTING      The connection is connecting.\n * @property {4} RECONNECTING    The connection is restarting.\n */\nexport enum ConnectionStatus\n{\n\tDISCONNECTED = 0,\n\tCONNECTED = 1,\n\tDISCONNECTING = 2,\n\tCONNECTING = 3,\n\tRECONNECTING = 4,\n}\n","import type { RPCError, RPCParameter, RPCResponse, RPCNotification } from './rpc-interfaces';\nimport type { ElectrumSocketOptions } from '@electrum-cash/socket';\n\n/**\n * Optional settings that change the default behavior of the network connection.\n */\nexport interface ElectrumNetworkOptions extends Partial<ElectrumSocketOptions>\n{\n\t/** If set to true, numbers that can safely be parsed as integers will be `BigInt` rather than `Number`. */\n\tuseBigInt?: boolean;\n\n\t/** When connected, send a keep-alive Ping message this often. */\n\tsendKeepAliveIntervalInMilliSeconds?: number;\n\n\t/** When disconnected, attempt to reconnect after this amount of time. */\n\treconnectAfterMilliSeconds?: number;\n\n\t/** After every send, verify that we have received data after this amount of time. */\n\tverifyConnectionTimeoutInMilliSeconds?: number;\n}\n\n/**\n * @ignore\n */\nexport interface VersionRejected\n{\n\terror: RPCError;\n}\n\n/**\n * @ignore\n */\nexport interface VersionNegotiated\n{\n\tsoftware: string;\n\tprotocol: string;\n}\n\n/**\n * @ignore\n */\nexport type VersionNegotiationResponse = VersionNegotiated | VersionRejected;\n\n/**\n * List of events emitted by the ElectrumConnection.\n * @event\n * @ignore\n */\nexport interface ElectrumConnectionEvents\n{\n\t/**\n\t * Emitted when any data has been received over the network.\n\t * @eventProperty\n\t */\n\t'received': [];\n\n\t/**\n\t * Emitted when a complete electrum message has been received over the network.\n\t * @eventProperty\n\t */\n\t'response': [ RPCResponse ];\n\n\t/**\n\t * Emitted when the connection has completed version negotiation.\n\t * @eventProperty\n\t */\n\t'version': [ VersionNegotiationResponse ];\n\n\t/**\n\t * Emitted when a network connection is initiated.\n\t * @eventProperty\n\t */\n\t'connecting': [];\n\n\t/**\n\t * Emitted when a network connection is successful.\n\t * @eventProperty\n\t */\n\t'connected': [];\n\n\t/**\n\t * Emitted when a network disconnection is initiated.\n\t * @eventProperty\n\t */\n\t'disconnecting': [];\n\n\t/**\n\t * Emitted when a network disconnection is successful.\n\t * @eventProperty\n\t */\n\t'disconnected': [];\n\n\t/**\n\t * Emitted when a network connect attempts to automatically reconnect.\n\t * @eventProperty\n\t */\n\t'reconnecting': [];\n\n\t/**\n\t * Emitted when the network has failed in some way.\n\t * @eventProperty\n\t */\n\t'error': [ Error ];\n}\n\n/**\n * List of events emitted by the ElectrumClient.\n * @event\n * @ignore\n */\nexport interface ElectrumClientEvents\n{\n\t/**\n\t * Emitted when an electrum subscription statement has been received over the network.\n\t * @eventProperty\n\t */\n\t'notification': [ RPCNotification ];\n\n\t/**\n\t * Emitted when a network connection is initiated.\n\t * @eventProperty\n\t */\n\t'connecting': [];\n\n\t/**\n\t * Emitted when a network connection is successful.\n\t * @eventProperty\n\t */\n\t'connected': [];\n\n\t/**\n\t * Emitted when a network disconnection is initiated.\n\t * @eventProperty\n\t */\n\t'disconnecting': [];\n\n\t/**\n\t * Emitted when a network disconnection is successful.\n\t * @eventProperty\n\t */\n\t'disconnected': [];\n\n\t/**\n\t * Emitted when a network connect attempts to automatically reconnect.\n\t * @eventProperty\n\t */\n\t'reconnecting': [];\n\n\t/**\n\t * Emitted when the network has failed in some way.\n\t * @eventProperty\n\t */\n\t'error': [ Error ];\n}\n\n/**\n * A list of possible responses to requests.\n * @ignore\n */\nexport type RequestResponse = RPCParameter | RPCParameter[];\n\n/**\n * Request resolvers are used to process the response of a request. This takes either\n * an error object or any stringified data, while the other parameter is omitted.\n * @ignore\n */\nexport type RequestResolver = (error?: Error, data?: string) => void;\n\n/**\n * Typing for promise resolution.\n * @ignore\n */\nexport type ResolveFunction<T> = (value: T | PromiseLike<T>) => void;\n\n/**\n * Typing for promise rejection.\n * @ignore\n */\nexport type RejectFunction = (reason?: unknown) => void;\n\n/**\n * @ignore\n */\nexport const isVersionRejected = function(object: VersionNegotiationResponse): object is VersionRejected\n{\n\treturn 'error' in object;\n};\n\n/**\n * @ignore\n */\nexport const isVersionNegotiated = function(object: VersionNegotiationResponse): object is VersionNegotiated\n{\n\treturn 'software' in object && 'protocol' in object;\n};\n","import debug from '@electrum-cash/debug-logs';\nimport { ElectrumWebSocket } from '@electrum-cash/web-socket';\nimport { ElectrumProtocol } from './electrum-protocol.ts';\nimport { isRPCNotification, isRPCErrorResponse } from './rpc-interfaces.ts';\nimport { EventEmitter } from 'eventemitter3';\nimport { ConnectionStatus } from './enums.ts';\nimport { parse, parseNumberAndBigInt } from 'lossless-json';\nimport { isVersionRejected } from './interfaces.ts';\nimport type { ElectrumNetworkOptions, ElectrumConnectionEvents, ResolveFunction, RejectFunction, VersionNegotiationResponse } from './interfaces.ts';\nimport type { RPCResponse } from './rpc-interfaces.ts';\nimport type { ElectrumSocket } from '@electrum-cash/socket';\n\n/**\n * Wrapper around TLS/WSS sockets that gracefully separates a network stream into Electrum protocol messages.\n */\nexport class ElectrumConnection extends EventEmitter<ElectrumConnectionEvents>\n{\n\t// Initialize the connected flag to false to indicate that there is no connection\n\tpublic status: ConnectionStatus = ConnectionStatus.DISCONNECTED;\n\n\t// Declare empty timestamps\n\tprivate lastReceivedTimestamp: number;\n\n\t// Declare an empty socket.\n\tprivate socket: ElectrumSocket;\n\n\t// Declare timers for keep-alive pings and reconnection\n\tprivate keepAliveTimer?: number;\n\tprivate reconnectTimer?: number;\n\n\t// Initialize an empty array of connection verification timers.\n\tprivate verifications: Array<number> = [];\n\n\t// Initialize messageBuffer to an empty string\n\tprivate messageBuffer = '';\n\n\t/**\n\t * Sets up network configuration for an Electrum client connection.\n\t *\n\t * @param application       - your application name, used to identify to the electrum host.\n\t * @param version           - protocol version to use with the host.\n\t * @param socketOrHostname  - pre-configured electrum socket or fully qualified domain name or IP number of the host\n\t * @param options           - ...\n\t *\n\t * @throws {Error} if `version` is not a valid version string.\n\t */\n\tconstructor(\n\t\tprivate application: string,\n\t\tprivate version: string,\n\t\tprivate socketOrHostname: ElectrumSocket | string,\n\t\tprivate options: ElectrumNetworkOptions,\n\t)\n\t{\n\t\t// Initialize the event emitter.\n\t\tsuper();\n\n\t\t// Check if the provided version is a valid version number.\n\t\tif(!ElectrumProtocol.versionRegexp.test(version))\n\t\t{\n\t\t\t// Throw an error since the version number was not valid.\n\t\t\tthrow(new Error(`Provided version string (${version}) is not a valid protocol version number.`));\n\t\t}\n\n\t\t// If a hostname was provided..\n\t\tif(typeof socketOrHostname === 'string')\n\t\t{\n\t\t\t// Use a web socket with default parameters.\n\t\t\tthis.socket = new ElectrumWebSocket(socketOrHostname, this.options);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Use the provided socket.\n\t\t\tthis.socket = socketOrHostname;\n\t\t}\n\n\t\t// Set up handlers for connection and disconnection.\n\t\tthis.socket.on('connected', this.onSocketConnect.bind(this));\n\t\tthis.socket.on('disconnected', this.onSocketDisconnect.bind(this));\n\n\t\t// Set up handler for incoming data.\n\t\tthis.socket.on('data', this.parseMessageChunk.bind(this));\n\t}\n\n\t// Expose hostIdentifier from the socket.\n\tget hostIdentifier(): string\n\t{\n\t\treturn this.socket.host;\n\t}\n\n\t// Expose port from the socket.\n\tget encrypted(): boolean\n\t{\n\t\treturn this.socket.options.encrypted;\n\t}\n\n\t/**\n\t * Assembles incoming data into statements and hands them off to the message parser.\n\t *\n\t * @param data - data to append to the current message buffer, as a string.\n\t *\n\t * @throws {SyntaxError} if the passed statement parts are not valid JSON.\n\t */\n\tparseMessageChunk(data: string): void\n\t{\n\t\t// Update the timestamp for when we last received data.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\n\t\t// Emit a notification indicating that the connection has received data.\n\t\tthis.emit('received');\n\n\t\t// Clear and remove all verification timers.\n\t\tthis.verifications.forEach((timer) => clearTimeout(timer));\n\t\tthis.verifications.length = 0;\n\n\t\t// Add the message to the current message buffer.\n\t\tthis.messageBuffer += data;\n\n\t\t// Check if the new message buffer contains the statement delimiter.\n\t\twhile(this.messageBuffer.includes(ElectrumProtocol.statementDelimiter))\n\t\t{\n\t\t\t// Split message buffer into statements.\n\t\t\tconst statementParts = this.messageBuffer.split(ElectrumProtocol.statementDelimiter);\n\n\t\t\t// For as long as we still have statements to parse..\n\t\t\twhile(statementParts.length > 1)\n\t\t\t{\n\t\t\t\t// Move the first statement to its own variable.\n\t\t\t\tconst currentStatementList = String(statementParts.shift());\n\n\t\t\t\t// Parse the statement into an object or list of objects.\n\t\t\t\tlet statementList = parse(currentStatementList, null, this.options.useBigInt ? parseNumberAndBigInt : parseFloat) as RPCResponse | RPCResponse[];\n\n\t\t\t\t// Wrap the statement in an array if it is not already a batched statement list.\n\t\t\t\tif(!Array.isArray(statementList))\n\t\t\t\t{\n\t\t\t\t\tstatementList = [ statementList ];\n\t\t\t\t}\n\n\t\t\t\t// For as long as there is statements in the result set..\n\t\t\t\twhile(statementList.length > 0)\n\t\t\t\t{\n\t\t\t\t\t// Move the first statement from the batch to its own variable.\n\t\t\t\t\tconst currentStatement = statementList.shift();\n\n\t\t\t\t\t// If the current statement is a subscription notification..\n\t\t\t\t\tif(isRPCNotification(currentStatement))\n\t\t\t\t\t{\n\t\t\t\t\t\t// Emit the notification for handling higher up in the stack.\n\t\t\t\t\t\tthis.emit('response', currentStatement);\n\n\t\t\t\t\t\t// Consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// If the current statement is a version negotiation response..\n\t\t\t\t\tif(currentStatement.id === 'versionNegotiation')\n\t\t\t\t\t{\n\t\t\t\t\t\tif(isRPCErrorResponse(currentStatement))\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Then emit a failed version negotiation response signal.\n\t\t\t\t\t\t\tthis.emit('version', { error: currentStatement.error });\n\t\t\t\t\t\t}\n\t\t\t\t\t\telse\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t// Extract the software and protocol version reported.\n\t\t\t\t\t\t\tconst [ software, protocol ] = currentStatement.result;\n\n\t\t\t\t\t\t\t// Emit a successful version negotiation response signal.\n\t\t\t\t\t\t\tthis.emit('version', { software, protocol });\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// If the current statement is a keep-alive response..\n\t\t\t\t\tif(currentStatement.id === 'keepAlive')\n\t\t\t\t\t{\n\t\t\t\t\t\t// Do nothing and consider this statement handled.\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\t// Emit the statements for handling higher up in the stack.\n\t\t\t\t\tthis.emit('response', currentStatement);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Store the remaining statement as the current message buffer.\n\t\t\tthis.messageBuffer = statementParts.shift() || '';\n\t\t}\n\t}\n\n\t/**\n\t * Sends a keep-alive message to the host.\n\t *\n\t * @returns true if the ping message was fully flushed to the socket, false if\n\t * part of the message is queued in the user memory\n\t */\n\tasync ping(): Promise<boolean>\n\t{\n\t\t// Write a log message.\n\t\tdebug.ping(`Sending keep-alive ping to '${this.hostIdentifier}'`);\n\n\t\t// Craft a keep-alive message.\n\t\tconst message = ElectrumProtocol.buildRequestObject('server.ping', [], 'keepAlive');\n\n\t\ttry\n\t\t{\n\t\t\t// Send the keep-alive message and return the send status.\n\t\t\treturn await this.send(message);\n\t\t}\n\t\tcatch (_ignored)\n\t\t{\n\t\t\t// Return false to indicate that the ping was not sent.\n\t\t\t// NOTE: A closed socket is reported separately through the 'disconnected' event.\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Initiates the network connection negotiates a protocol version. Also emits the 'connect' signal if successful.\n\t *\n\t * @throws {Error} if the socket connection fails.\n\t * @returns a promise resolving when the connection is established\n\t */\n\tasync connect(): Promise<void>\n\t{\n\t\t// If we are already connected return true.\n\t\tif(this.status === ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Indicate that the connection is connecting\n\t\tthis.status = ConnectionStatus.CONNECTING;\n\n\t\t// Emit a connect event now that the connection is being set up.\n\t\tthis.emit('connecting');\n\n\t\t// Declare the functions that settle the connection promise.\n\t\tlet resolveConnection: ResolveFunction<void>;\n\t\tlet rejectConnection: RejectFunction;\n\n\t\t// Create a promise that is settled by the events below, once the connection is established or lost.\n\t\tconst connectionPromise = new Promise<void>((resolve, reject) =>\n\t\t{\n\t\t\tresolveConnection = resolve;\n\t\t\trejectConnection = reject;\n\t\t});\n\n\t\t// Define a function to resolve the connection promise once the connection is established.\n\t\t// NOTE: This event is emitted by onSocketConnect after successful version negotiation.\n\t\tconst onConnected = (): void =>\n\t\t{\n\t\t\tresolveConnection();\n\t\t};\n\n\t\t// Declare the error reported by the socket while connecting, if any.\n\t\tlet socketError: unknown;\n\n\t\t// Define a function to reject the connection promise if the connection is lost before it is established.\n\t\t// NOTE: This runs after onSocketDisconnect has updated the connection state, so callers see a settled state.\n\t\tconst onDisconnected = (): void =>\n\t\t{\n\t\t\trejectConnection(socketError ?? new Error(`Failed to connect to '${this.hostIdentifier}'.`));\n\t\t};\n\n\t\t// Settle the connection promise on whichever event happens first.\n\t\tthis.once('connected', onConnected);\n\t\tthis.once('disconnected', onDisconnected);\n\n\t\ttry\n\t\t{\n\t\t\t// Start the socket connection process.\n\t\t\tawait this.socket.connect();\n\t\t}\n\t\tcatch (error)\n\t\t{\n\t\t\t// Keep the error as the reason for the failed connection.\n\t\t\t// NOTE: A failed socket connection is reported both by rejecting this promise and through the 'disconnected'\n\t\t\t//       event. The event is what settles the connection promise, so that the connection state is already\n\t\t\t//       updated when the caller is told; the error is only kept to give the caller the reason.\n\t\t\tsocketError = error;\n\t\t}\n\n\t\ttry\n\t\t{\n\t\t\t// Wait until connection is established and version negotiation succeeds.\n\t\t\tawait connectionPromise;\n\t\t}\n\t\tfinally\n\t\t{\n\t\t\t// Remove whichever listener did not fire, so that it cannot linger until the next event.\n\t\t\tthis.removeListener('connected', onConnected);\n\t\t\tthis.removeListener('disconnected', onDisconnected);\n\t\t}\n\t}\n\n\t/**\n\t * Restores the network connection.\n\t */\n\tasync reconnect(): Promise<void>\n\t{\n\t\t// If a reconnect timer is set, remove it\n\t\tawait this.clearReconnectTimer();\n\n\t\t// Write a log message.\n\t\tdebug.network(`Trying to reconnect to '${this.hostIdentifier}'..`);\n\n\t\t// Set the status to reconnecting for more accurate log messages.\n\t\tthis.status = ConnectionStatus.RECONNECTING;\n\n\t\t// Emit a connect event now that the connection is usable.\n\t\tthis.emit('reconnecting');\n\n\t\t// Disconnect the underlying socket\n\t\tthis.closeSocket();\n\n\t\ttry\n\t\t{\n\t\t\t// Try to connect again.\n\t\t\tawait this.connect();\n\t\t}\n\t\tcatch (_error)\n\t\t{\n\t\t\t// Do nothing as the error should be handled via the disconnect and error signals.\n\t\t}\n\t}\n\n\t/**\n\t * Removes the current reconnect timer.\n\t */\n\tclearReconnectTimer(): void\n\t{\n\t\t// If a reconnect timer is set, remove it\n\t\tif(this.reconnectTimer)\n\t\t{\n\t\t\tclearTimeout(this.reconnectTimer);\n\t\t}\n\n\t\t// Reset the timer reference.\n\t\tthis.reconnectTimer = undefined;\n\t}\n\n\t/**\n\t * Removes the current keep-alive timer.\n\t */\n\tclearKeepAliveTimer(): void\n\t{\n\t\t// If a keep-alive timer is set, remove it\n\t\tif(this.keepAliveTimer)\n\t\t{\n\t\t\tclearTimeout(this.keepAliveTimer);\n\t\t}\n\n\t\t// Reset the timer reference.\n\t\tthis.keepAliveTimer = undefined;\n\t}\n\n\t/**\n\t * Initializes the keep alive timer loop.\n\t */\n\tsetupKeepAliveTimer(): void\n\t{\n\t\t// If the keep-alive timer loop is not currently set up..\n\t\tif(!this.keepAliveTimer)\n\t\t{\n\t\t\t// Set a new keep-alive timer.\n\t\t\tthis.keepAliveTimer = setTimeout(this.ping.bind(this), this.options.sendKeepAliveIntervalInMilliSeconds) as unknown as number;\n\t\t}\n\t}\n\n\t/**\n\t * Tears down the current connection and removes all event listeners on disconnect.\n\t *\n\t * @param force       - disconnect even if the connection has not been fully established yet.\n\t * @param intentional - update connection state if disconnect is intentional.\n\t *\n\t * @returns true if successfully disconnected, or false if there was no connection.\n\t */\n\tasync disconnect(force: boolean = false, intentional: boolean = true): Promise<boolean>\n\t{\n\t\t// Return early when there is nothing to disconnect from\n\t\tif(this.status === ConnectionStatus.DISCONNECTED && !force)\n\t\t{\n\t\t\t// Return false to indicate that there was nothing to disconnect from.\n\t\t\treturn false;\n\t\t}\n\n\t\t// Update connection state if the disconnection is intentional.\n\t\t// NOTE: The state is meant to represent what the client is requesting, but\n\t\t//       is used internally to handle visibility changes in browsers to ensure functional reconnection.\n\t\tif(intentional)\n\t\t{\n\t\t\t// Set connection status to null to indicate tear-down is currently happening.\n\t\t\tthis.status = ConnectionStatus.DISCONNECTING;\n\t\t}\n\n\t\t// Emit a connect event to indicate that we are disconnecting.\n\t\tthis.emit('disconnecting');\n\n\t\t// If a keep-alive timer is set, remove it.\n\t\tawait this.clearKeepAliveTimer();\n\n\t\t// If a reconnect timer is set, remove it\n\t\tawait this.clearReconnectTimer();\n\n\t\tconst disconnectResolver = (resolve: ResolveFunction<boolean>): void =>\n\t\t{\n\t\t\t// If the socket is already disconnected it will not emit a 'disconnected' event,\n\t\t\t// so we finalize the disconnection directly instead of waiting for the event.\n\t\t\t// NOTE: This happens when disconnecting before a connection was made, or after a connection was lost.\n\t\t\tif(this.socket.isDisconnected)\n\t\t\t{\n\t\t\t\t// Update the connection state as if the socket had reported the disconnection.\n\t\t\t\tthis.onSocketDisconnect();\n\n\t\t\t\t// Resolve to true as the connection has been torn down.\n\t\t\t\tresolve(true);\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Resolve to true after the connection emits a disconnect\n\t\t\tthis.once('disconnected', () => resolve(true));\n\n\t\t\t// Close the connection on the socket level.\n\t\t\tthis.closeSocket();\n\t\t};\n\n\t\t// Return true to indicate that we disconnected.\n\t\treturn new Promise<boolean>(disconnectResolver);\n\t}\n\n\t/**\n\t * Sends an arbitrary message to the server.\n\t *\n\t * @param message - json encoded request object to send to the server, as a string.\n\t *\n\t * @returns true if the message was fully flushed to the socket, false if part of the message\n\t * is queued in the user memory\n\t */\n\tasync send(message: string): Promise<boolean>\n\t{\n\t\t// Remove the current keep-alive timer if it exists.\n\t\tthis.clearKeepAliveTimer();\n\n\t\t// Get the current timestamp in milliseconds.\n\t\tconst currentTime = Date.now();\n\n\t\t// Follow up and verify that the message got sent..\n\t\tconst verificationTimer = setTimeout(this.verifySend.bind(this, currentTime), this.socket.options.timeoutInMilliSeconds) as unknown as number;\n\n\t\t// Store the verification timer locally so that it can be cleared when data has been received.\n\t\tthis.verifications.push(verificationTimer);\n\n\t\t// Set a new keep-alive timer.\n\t\tthis.setupKeepAliveTimer();\n\n\t\t// Write the message to the network socket.\n\t\treturn this.socket.write(message + ElectrumProtocol.statementDelimiter);\n\t}\n\n\t/**\n\t * Closes the underlying socket.\n\t *\n\t * @remarks The socket reports the closed connection through its 'disconnected' event, which is what drives\n\t *          our connection state. Any promise returned by the socket is consumed here so that a failure to\n\t *          close cannot surface as an unhandled rejection.\n\t */\n\tasync closeSocket(): Promise<void>\n\t{\n\t\ttry\n\t\t{\n\t\t\t// Close the connection on the socket level.\n\t\t\tawait this.socket.disconnect();\n\t\t}\n\t\tcatch (error)\n\t\t{\n\t\t\t// Log a warning, as there is nothing we can do to actually handle it.\n\t\t\tdebug.warning(`Failed to close the socket for '${this.hostIdentifier}': `, error);\n\t\t}\n\t}\n\n\t// --- Event managers. --- //\n\n\t/**\n\t * Marks the connection as timed out and schedules reconnection if we have not\n\t * received data within the expected time frame.\n\t */\n\tverifySend(sentTimestamp: number): void\n\t{\n\t\t// If we haven't received any data since we last sent data out..\n\t\tif(Number(this.lastReceivedTimestamp) < sentTimestamp)\n\t\t{\n\t\t\t// If this connection is already disconnected, we do not change anything\n\t\t\tif((this.status === ConnectionStatus.DISCONNECTED) || (this.status === ConnectionStatus.DISCONNECTING))\n\t\t\t{\n\t\t\t\t// debug.warning(`Tried to verify already disconnected connection to '${this.hostIdentifier}'`);\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Remove the current keep-alive timer if it exists.\n\t\t\tthis.clearKeepAliveTimer();\n\n\t\t\t// Write a notification to the logs.\n\t\t\tdebug.network(`Connection to '${this.hostIdentifier}' timed out.`);\n\n\t\t\t// Close the connection to avoid re-use.\n\t\t\t// NOTE: This initiates reconnection routines if the connection has not\n\t\t\t//       been marked as intentionally disconnected.\n\t\t\tthis.closeSocket();\n\t\t}\n\t}\n\n\t/**\n\t * Updates the connection status when a connection is confirmed.\n\t */\n\tasync onSocketConnect(): Promise<void>\n\t{\n\t\t// If a reconnect timer is set, remove it.\n\t\tthis.clearReconnectTimer();\n\n\t\t// Set up the initial timestamp for when we last received data from the server.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\n\t\t// Set up the initial keep-alive timer.\n\t\tthis.setupKeepAliveTimer();\n\n\t\ttry\n\t\t{\n\t\t\t// Wait for the version to be negotiated.\n\t\t\tawait this.negotiateVersion();\n\t\t}\n\t\tcatch (error)\n\t\t{\n\t\t\t// Log the failure, as the connection has already been torn down by the version negotiation.\n\t\t\tdebug.errors(`Aborted connection with '${this.hostIdentifier}': `, error);\n\n\t\t\t// Do not emit the connected event, since the connection is not usable.\n\t\t\treturn;\n\t\t}\n\n\t\t// Emit a connect event now that the connection is established and version negotiated.\n\t\tthis.emit('connected');\n\t}\n\n\t/**\n\t * Updates the connection status when a connection is ended.\n\t */\n\tonSocketDisconnect(): void\n\t{\n\t\t// Remove the current keep-alive timer if it exists.\n\t\tthis.clearKeepAliveTimer();\n\n\t\t// If this is a connection we're trying to tear down..\n\t\tif(this.status === ConnectionStatus.DISCONNECTING)\n\t\t{\n\t\t\t// Mark the connection as disconnected.\n\t\t\tthis.status = ConnectionStatus.DISCONNECTED;\n\n\t\t\t// Send a disconnect signal higher up the stack.\n\t\t\tthis.emit('disconnected');\n\n\t\t\t// If a reconnect timer is set, remove it.\n\t\t\tthis.clearReconnectTimer();\n\n\t\t\t// Remove all event listeners\n\t\t\tthis.removeAllListeners();\n\n\t\t\t// Write a log message.\n\t\t\tdebug.network(`Disconnected from '${this.hostIdentifier}'.`);\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// If this is for an established connection..\n\t\t\tif(this.status === ConnectionStatus.CONNECTED)\n\t\t\t{\n\t\t\t\t// Write a notification to the logs.\n\t\t\t\tdebug.errors(`Connection with '${this.hostIdentifier}' was closed, trying to reconnect in ${this.options.reconnectAfterMilliSeconds / 1000} seconds.`);\n\t\t\t}\n\t\t\t// If this is a connection that is currently connecting, reconnecting or already disconnected..\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Do nothing\n\n\t\t\t\t// NOTE: This error message is useful during manual debugging of reconnections.\n\t\t\t\t// debug.errors(`Lost connection with reconnecting or already disconnected server '${this.hostIdentifier}'.`);\n\t\t\t}\n\n\t\t\t// Mark the connection as disconnected for now..\n\t\t\tthis.status = ConnectionStatus.DISCONNECTED;\n\n\t\t\t// Send a disconnect signal higher up the stack.\n\t\t\tthis.emit('disconnected');\n\n\t\t\t// If we don't have a pending reconnection timer..\n\t\t\tif(!this.reconnectTimer)\n\t\t\t{\n\t\t\t\t// Attempt to reconnect after one keep-alive duration.\n\t\t\t\tthis.reconnectTimer = setTimeout(this.reconnect.bind(this), this.options.reconnectAfterMilliSeconds) as unknown as number;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Notify administrator of any unexpected errors.\n\t */\n\tonSocketError(error: unknown | undefined): void\n\t{\n\t\t// Report a generic error if no error information is present.\n\t\t// NOTE: When using WSS, the error event explicitly\n\t\t//       only allows to send a \"simple\" event without data.\n\t\t//       https://stackoverflow.com/a/18804298\n\t\tif(typeof error === 'undefined')\n\t\t{\n\t\t\t// Do nothing, and instead rely on the socket disconnect event for further information.\n\t\t\treturn;\n\t\t}\n\n\t\t// Log the error, as there is nothing we can do to actually handle it.\n\t\tdebug.errors(`Network error ('${this.hostIdentifier}'): `, error);\n\t}\n\n\t/**\n\t * Negotiates the protocol version with the server, and disconnects if the negotiation fails.\n\t *\n\t * @throws {Error} if the server rejects or negotiates an incompatible protocol version, or the connection is lost.\n\t * @returns a promise resolving when the protocol version has been negotiated.\n\t */\n\tasync negotiateVersion(): Promise<void>\n\t{\n\t\t// Declare the functions that settle the negotiation promise.\n\t\tlet resolveNegotiation: ResolveFunction<void>;\n\t\tlet rejectNegotiation: RejectFunction;\n\n\t\t// Create a promise that is settled by the handlers below, once the negotiation has completed or failed.\n\t\tconst negotiationPromise = new Promise<void>((resolve, reject) =>\n\t\t{\n\t\t\tresolveNegotiation = resolve;\n\t\t\trejectNegotiation = reject;\n\t\t});\n\n\t\t// Define a function to reject the negotiation if the connection is lost while negotiating.\n\t\t// NOTE: The connection state is updated by onSocketDisconnect, which handles the same event.\n\t\tconst rejector = (): void =>\n\t\t{\n\t\t\t// Reject with the error as reason\n\t\t\trejectNegotiation(new Error(`Version negotiation with '${this.hostIdentifier}' failed due to lost connection.`));\n\t\t};\n\n\t\t// Define a function to wrap version validation as a function.\n\t\tconst versionValidator = (version: VersionNegotiationResponse): void =>\n\t\t{\n\t\t\t// Check if version negotiation failed.\n\t\t\tif(isVersionRejected(version))\n\t\t\t{\n\t\t\t\t// Disconnect from the host.\n\t\t\t\tthis.disconnect(true);\n\n\t\t\t\t// Declare an error message.\n\t\t\t\tconst errorMessage = 'unsupported protocol version.';\n\n\t\t\t\t// Log the error.\n\t\t\t\tdebug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);\n\n\t\t\t\t// Reject the negotiation since the server refused the protocol version.\n\t\t\t\trejectNegotiation(new Error(errorMessage));\n\t\t\t}\n\t\t\t// Check if the host supports our requested protocol version.\n\t\t\t// NOTE: the server responds with version numbers that truncate 0's, so 1.5.0 turns into 1.5.\n\t\t\telse if((version.protocol !== this.version) && (`${version.protocol}.0` !== this.version) && (`${version.protocol}.0.0` !== this.version))\n\t\t\t{\n\t\t\t\t// Disconnect from the host.\n\t\t\t\tthis.disconnect(true);\n\n\t\t\t\t// Declare an error message.\n\t\t\t\tconst errorMessage = `incompatible protocol version negotiated (${version.protocol} !== ${this.version}).`;\n\n\t\t\t\t// Log the error.\n\t\t\t\tdebug.errors(`Failed to connect with ${this.hostIdentifier} due to ${errorMessage}`);\n\n\t\t\t\t// Reject the negotiation since the protocol versions are incompatible.\n\t\t\t\trejectNegotiation(new Error(errorMessage));\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// Write a log message.\n\t\t\t\tdebug.network(`Negotiated protocol version ${version.protocol} with '${this.hostIdentifier}', powered by ${version.software}.`);\n\n\t\t\t\t// Set connection status to connected\n\t\t\t\tthis.status = ConnectionStatus.CONNECTED;\n\n\t\t\t\t// Resolve the negotiation since the protocol version was accepted.\n\t\t\t\tresolveNegotiation();\n\t\t\t}\n\t\t};\n\n\t\t// Write a log message to show that we have started version negotiation.\n\t\tdebug.network(`Requesting protocol version ${this.version} with '${this.hostIdentifier}'.`);\n\n\t\t// Settle the negotiation promise on whichever event happens first.\n\t\tthis.socket.once('disconnected', rejector);\n\t\tthis.once('version', versionValidator);\n\n\t\t// Build a version negotiation message.\n\t\tconst versionMessage = ElectrumProtocol.buildRequestObject('server.version', [ this.application, this.version ], 'versionNegotiation');\n\n\t\ttry\n\t\t{\n\t\t\t// Send the version negotiation message.\n\t\t\tawait this.send(versionMessage);\n\t\t}\n\t\tcatch (_ignored)\n\t\t{\n\t\t\t// Do nothing, as a failed send means the socket has closed, which is reported through the 'disconnected' event.\n\t\t}\n\n\t\ttry\n\t\t{\n\t\t\t// Wait until the server has answered the version negotiation.\n\t\t\tawait negotiationPromise;\n\t\t}\n\t\tfinally\n\t\t{\n\t\t\t// Remove whichever listener did not fire, so that it cannot linger until the next event.\n\t\t\tthis.socket.removeListener('disconnected', rejector);\n\t\t\tthis.removeListener('version', versionValidator);\n\t\t}\n\t}\n}\n","import type { ElectrumNetworkOptions } from './interfaces.ts';\n\n// Define number of milliseconds per second for legibility.\nconst MILLI_SECONDS_PER_SECOND = 1000;\n\n/**\n * Configure default options.\n */\nexport const defaultNetworkOptions: ElectrumNetworkOptions =\n{\n\t// By default, all numbers including integers are parsed as regular JavaScript numbers.\n\tuseBigInt: false,\n\n\t// Send a ping message every seconds, to detect network problem as early as possible.\n\tsendKeepAliveIntervalInMilliSeconds: 1 * MILLI_SECONDS_PER_SECOND,\n\n\t// Try to reconnect 5 seconds after unintentional disconnects.\n\treconnectAfterMilliSeconds: 5 * MILLI_SECONDS_PER_SECOND,\n\n\t// Try to detect stale connections 5 seconds after every send.\n\tverifyConnectionTimeoutInMilliSeconds: 5 * MILLI_SECONDS_PER_SECOND,\n};\n","import debug from '@electrum-cash/debug-logs';\nimport { ElectrumConnection } from './electrum-connection.ts';\nimport { ElectrumProtocol } from './electrum-protocol.ts';\nimport { defaultNetworkOptions } from './constants.ts';\nimport { ConnectionStatus } from './enums.ts';\nimport { EventEmitter } from 'eventemitter3';\nimport { Mutex } from 'async-mutex';\nimport { isRPCNotification, isRPCErrorResponse } from './rpc-interfaces.ts';\nimport type { RPCParameter, RPCNotification, RPCResponse } from './rpc-interfaces.ts';\nimport type { ElectrumNetworkOptions, ElectrumClientEvents, ResolveFunction, RequestResolver, RequestResponse } from './interfaces.ts';\nimport type { ElectrumSocket } from '@electrum-cash/socket';\n\n/**\n * High-level Electrum client that lets applications send requests and subscribe to notification events from a server.\n */\nclass ElectrumClient<ElectrumEvents extends ElectrumClientEvents> extends EventEmitter<ElectrumClientEvents | ElectrumEvents> implements ElectrumClientEvents\n{\n\t/**\n\t * The name and version of the server software indexing the blockchain.\n\t */\n\tpublic software: string;\n\n\t/**\n\t * The genesis hash of the blockchain indexed by the server.\n\t * @remarks This is only available after a 'server.features' call.\n\t */\n\tpublic genesisHash: string;\n\n\t/**\n\t * The chain height of the blockchain indexed by the server.\n\t * @remarks This is only available after a 'blockchain.headers.subscribe' call.\n\t */\n\tpublic chainHeight: number;\n\n\t/**\n\t * Timestamp of when we last received data from the server indexing the blockchain.\n\t */\n\tpublic lastReceivedTimestamp: number;\n\n\t/**\n\t * Number corresponding to the underlying connection status.\n\t */\n\tpublic get status(): ConnectionStatus\n\t{\n\t\treturn this.connection.status;\n\t}\n\n\t// Declare instance variables\n\tprivate connection: ElectrumConnection;\n\n\t// Initialize an empty list of subscription metadata.\n\tprivate subscriptionMethods: Record<string, Set<string>> = {};\n\n\t// Start counting the request IDs from 0\n\tprivate requestId = 0;\n\n\t// Initialize an empty dictionary for keeping track of request resolvers\n\tprivate requestResolvers: { [index: number]: RequestResolver } = {};\n\n\t// Mutex lock used to prevent simultaneous connect() and disconnect() calls.\n\tprivate connectionLock = new Mutex();\n\n\t/**\n\t * Initializes an Electrum client.\n\t *\n\t * @param application       - your application name, used to identify to the electrum host.\n\t * @param version           - protocol version to use with the host.\n\t * @param socketOrHostname  - pre-configured electrum socket or fully qualified domain name or IP number of the host\n\t * @param options           - ...\n\t *\n\t * @throws {Error} if `version` is not a valid version string.\n\t */\n\tconstructor(\n\t\tpublic application: string,\n\t\tpublic version: string,\n\t\tpublic socketOrHostname: ElectrumSocket | string,\n\t\tpublic options: Partial<ElectrumNetworkOptions> = {},\n\t)\n\t{\n\t\t// Initialize the event emitter.\n\t\tsuper();\n\n\t\t// Update default options with the provided values.\n\t\tconst networkOptions: ElectrumNetworkOptions = { ...defaultNetworkOptions, ...options };\n\n\t\t// Set up a connection to an electrum server.\n\t\tthis.connection = new ElectrumConnection(application, version, socketOrHostname, networkOptions);\n\t}\n\n\t// Expose hostIdentifier from the connection.\n\tget hostIdentifier(): string\n\t{\n\t\treturn this.connection.hostIdentifier;\n\t}\n\n\t// Expose port from the connection.\n\tget encrypted(): boolean\n\t{\n\t\treturn this.connection.encrypted;\n\t}\n\n\t/**\n\t * Connects to the remote server.\n\t *\n\t * @throws {Error} if the socket connection fails.\n\t * @returns a promise resolving when the connection is established.\n\t */\n\tasync connect(): Promise<void>\n\t{\n\t\t// Force concurrent calls to this function to be run serially.\n\t\treturn this.connectionLock.runExclusive(async () =>\n\t\t{\n\t\t\t// If we are already connected, do not attempt to connect again.\n\t\t\tif(this.connection.status === ConnectionStatus.CONNECTED)\n\t\t\t{\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Listen for parsed statements.\n\t\t\tthis.connection.on('response', this.response.bind(this));\n\n\t\t\t// Hook up handles for the connected and disconnected events.\n\t\t\tthis.connection.on('connected', this.resubscribeOnConnect.bind(this));\n\t\t\tthis.connection.on('disconnected', this.onConnectionDisconnect.bind(this));\n\n\t\t\t// Relay connecting and reconnecting events.\n\t\t\tthis.connection.on('connecting', this.handleConnectionStatusChanges.bind(this, 'connecting'));\n\t\t\tthis.connection.on('disconnecting', this.handleConnectionStatusChanges.bind(this, 'disconnecting'));\n\t\t\tthis.connection.on('reconnecting', this.handleConnectionStatusChanges.bind(this, 'reconnecting'));\n\n\t\t\t// Hook up client metadata gathering functions.\n\t\t\tthis.connection.on('version', this.storeSoftwareVersion.bind(this));\n\t\t\tthis.connection.on('received', this.updateLastReceivedTimestamp.bind(this));\n\n\t\t\t// Relay error events.\n\t\t\tthis.connection.on('error', this.emit.bind(this, 'error'));\n\n\t\t\t// Connect with the server.\n\t\t\tawait this.connection.connect();\n\t\t});\n\t}\n\n\t/**\n\t * Disconnects from the remote server and removes all event listeners/subscriptions and open requests.\n\t *\n\t * @param force               - disconnect even if the connection has not been fully established yet.\n\t * @param retainSubscriptions - retain subscription data so they will be restored on reconnection.\n\t *\n\t * @returns true if successfully disconnected, or false if there was no connection.\n\t */\n\tasync disconnect(force: boolean = false, retainSubscriptions: boolean = false): Promise<boolean>\n\t{\n\t\t// Force concurrent calls to this function to be run serially.\n\t\treturn this.connectionLock.runExclusive(async () =>\n\t\t{\n\t\t\tif(!retainSubscriptions)\n\t\t\t{\n\t\t\t\t// Cancel all event listeners.\n\t\t\t\tthis.removeAllListeners();\n\n\t\t\t\t// Remove all subscription data\n\t\t\t\tthis.subscriptionMethods = {};\n\t\t\t}\n\n\t\t\t// Disconnect from the remote server.\n\t\t\treturn this.connection.disconnect(force);\n\t\t});\n\t}\n\n\t/**\n\t * Calls a method on the remote server with the supplied parameters.\n\t *\n\t * @param method     - name of the method to call.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise that resolves with the result of the method or an Error.\n\t */\n\tasync request(method: string, ...parameters: RPCParameter[]): Promise<Error | RequestResponse>\n\t{\n\t\t// If we are not connected to a server..\n\t\tif(this.connection.status !== ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\t// Reject the request with a disconnected error message.\n\t\t\tthrow(new Error(`Unable to send request to a disconnected server '${this.hostIdentifier}'.`));\n\t\t}\n\n\t\t// Increase the request ID by one.\n\t\tthis.requestId += 1;\n\n\t\t// Store a copy of the request id.\n\t\tconst id = this.requestId;\n\n\t\t// Format the arguments as an electrum request object.\n\t\tconst message = ElectrumProtocol.buildRequestObject(method, parameters, id);\n\n\t\t// Define a function to wrap the request in a promise.\n\t\tconst requestResolver = (resolve: ResolveFunction<Error | RequestResponse>): void =>\n\t\t{\n\t\t\t// Add a request resolver for this promise to the list of requests.\n\t\t\tthis.requestResolvers[id] = (error?: Error, data?: RequestResponse) =>\n\t\t\t{\n\t\t\t\t// If the resolution failed..\n\t\t\t\tif(error)\n\t\t\t\t{\n\t\t\t\t\t// Resolve the promise with the error for the application to handle.\n\t\t\t\t\tresolve(error);\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// Resolve the promise with the request results.\n\t\t\t\t\tresolve(data);\n\t\t\t\t}\n\t\t\t};\n\n\t\t};\n\n\t\t// Create the promise that delivers the result once the response arrives.\n\t\tconst responsePromise = new Promise<Error | RequestResponse>(requestResolver);\n\n\t\t// Write a log message.\n\t\tdebug.network(`Sending request '${method}' to '${this.hostIdentifier}'`);\n\n\t\ttry\n\t\t{\n\t\t\t// Send the request message to the remote server.\n\t\t\tawait this.connection.send(message);\n\t\t}\n\t\tcatch (error)\n\t\t{\n\t\t\t// Settle the request with the error instead of leaving it pending, unless a lost connection already settled it.\n\t\t\tthis.abortRequest(id, error);\n\t\t}\n\n\t\t// return the promise to deliver results later.\n\t\treturn responsePromise;\n\t}\n\n\t/**\n\t * Settles a pending request with an error, for instance when its message could not be sent.\n\t *\n\t * @param id    - the id of the request to settle.\n\t * @param error - the reason the request failed.\n\t *\n\t * @ignore\n\t */\n\tprivate abortRequest(id: number, error: unknown): void\n\t{\n\t\t// Look up the request resolver, as the request may already have been settled by a lost connection.\n\t\tconst requestResolver = this.requestResolvers[id];\n\n\t\t// Do nothing if the request has already been settled.\n\t\tif(!requestResolver)\n\t\t{\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove the promise from the request list.\n\t\tdelete this.requestResolvers[id];\n\n\t\t// Resolve the request with the error for the application to handle.\n\t\trequestResolver(error instanceof Error ? error : new Error(String(error)));\n\t}\n\n\t/**\n\t * Subscribes to the method and payload at the server.\n\t *\n\t * @remarks the response for the subscription request is issued as a notification event.\n\t *\n\t * @param method     - one of the subscribable methods the server supports.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving when the subscription is established.\n\t */\n\tasync subscribe(method: string, ...parameters: RPCParameter[]): Promise<void>\n\t{\n\t\t// Initialize an empty list of subscription payloads, if needed.\n\t\tif(!this.subscriptionMethods[method])\n\t\t{\n\t\t\tthis.subscriptionMethods[method] = new Set<string>();\n\t\t}\n\n\t\t// Store the subscription parameters to track what data we have subscribed to.\n\t\tthis.subscriptionMethods[method].add(JSON.stringify(parameters));\n\n\t\t// Send initial subscription request.\n\t\tconst requestData = await this.request(method, ...parameters);\n\n\t\t// If the request failed, throw it as an error.\n\t\tif(requestData instanceof Error)\n\t\t{\n\t\t\tthrow(requestData);\n\t\t}\n\n\t\t// If the request returned more than one data point..\n\t\tif(Array.isArray(requestData))\n\t\t{\n\t\t\t// .. throw an error, as this breaks our expectation for subscriptions.\n\t\t\tthrow(new Error('Subscription request returned an more than one data point.'));\n\t\t}\n\n\t\t// Construct a notification structure to package the initial result as a notification.\n\t\tconst notification: RPCNotification =\n\t\t{\n\t\t\tjsonrpc: '2.0',\n\t\t\tmethod: method,\n\t\t\tparams: [ ...parameters, requestData ],\n\t\t};\n\n\t\t// Manually emit an event for the initial response.\n\t\tthis.emit('notification', notification);\n\n\t\t// Try to update the chain height.\n\t\tthis.updateChainHeightFromHeadersNotifications(notification);\n\t}\n\n\t/**\n\t * Unsubscribes to the method at the server and removes any callback functions\n\t * when there are no more subscriptions for the method.\n\t *\n\t * @param method     - a previously subscribed to method.\n\t * @param parameters - one or more parameters for the method.\n\t *\n\t * @throws {Error} if no subscriptions exist for the combination of the provided `method` and `parameters.\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving when the subscription is removed.\n\t */\n\tasync unsubscribe(method: string, ...parameters: RPCParameter[]): Promise<void>\n\t{\n\t\t// Throw an error if the client is disconnected.\n\t\tif(this.connection.status !== ConnectionStatus.CONNECTED)\n\t\t{\n\t\t\tthrow(new Error(`Unable to send unsubscribe request to a disconnected server '${this.hostIdentifier}'.`));\n\t\t}\n\n\t\t// If this method has no subscriptions..\n\t\tif(!this.subscriptionMethods[method])\n\t\t{\n\t\t\t// Reject this promise with an explanation.\n\t\t\tthrow(new Error(`Cannot unsubscribe from '${method}' since the method has no subscriptions.`));\n\t\t}\n\n\t\t// Pack up the parameters as a long string.\n\t\tconst subscriptionParameters = JSON.stringify(parameters);\n\n\t\t// If the method payload could not be located..\n\t\tif(!this.subscriptionMethods[method].has(subscriptionParameters))\n\t\t{\n\t\t\t// Reject this promise with an explanation.\n\t\t\tthrow(new Error(`Cannot unsubscribe from '${method}' since it has no subscription with the given parameters.`));\n\t\t}\n\n\t\t// Remove this specific subscription payload from internal tracking.\n\t\tthis.subscriptionMethods[method].delete(subscriptionParameters);\n\n\t\t// Send unsubscription request to the server\n\t\t// NOTE: As a convenience we allow users to define the method as the subscribe or unsubscribe version.\n\t\tawait this.request(method.replace('.subscribe', '.unsubscribe'), ...parameters);\n\n\t\t// Write a log message.\n\t\tdebug.client(`Unsubscribed from '${String(method)}' for the '${subscriptionParameters}' parameters.`);\n\t}\n\n\t/**\n\t * Restores existing subscriptions without updating status or triggering manual callbacks.\n\t *\n\t * @throws {Error} if subscription data cannot be found for all stored event names.\n\t * @throws {Error} if the client is disconnected.\n\t * @returns a promise resolving to true when the subscriptions are restored.\n\t *\n\t * @ignore\n\t */\n\tprivate async resubscribeOnConnect(): Promise<void>\n\t{\n\t\t// Write a log message.\n\t\tdebug.client(`Connected to '${this.hostIdentifier}'.`);\n\n\t\t// Synchronize with the underlying connection status.\n\t\tthis.handleConnectionStatusChanges('connected');\n\n\t\t// Initialize an empty list of resubscription promises.\n\t\tconst resubscriptionPromises = [];\n\n\t\t// For each method we have a subscription for..\n\t\tfor(const method in this.subscriptionMethods)\n\t\t{\n\t\t\t// .. and for each parameter we have previously been subscribed to..\n\t\t\tfor(const parameterJSON of this.subscriptionMethods[method].values())\n\t\t\t{\n\t\t\t\t// restore the parameters from JSON.\n\t\t\t\tconst parameters = JSON.parse(parameterJSON);\n\n\t\t\t\t// Send a subscription request.\n\t\t\t\tresubscriptionPromises.push(this.subscribe(method, ...parameters));\n\t\t\t}\n\n\t\t\t// Wait for all re-subscriptions to complete.\n\t\t\tawait Promise.all(resubscriptionPromises);\n\t\t}\n\n\t\t// Write a log message if there was any subscriptions to restore.\n\t\tif(resubscriptionPromises.length > 0)\n\t\t{\n\t\t\tdebug.client(`Restored ${resubscriptionPromises.length} previous subscriptions for '${this.hostIdentifier}'`);\n\t\t}\n\t}\n\n\t/**\n\t * Parser messages from the remote server to resolve request promises and emit subscription events.\n\t *\n\t * @param message - the response message\n\t *\n\t * @throws {Error} if the message ID does not match an existing request.\n\t * @ignore\n\t */\n\tresponse(message: RPCResponse): void\n\t{\n\t\t// If the received message is a notification, we forward it to all event listeners\n\t\tif(isRPCNotification(message))\n\t\t{\n\t\t\t// Write a log message.\n\t\t\tdebug.client(`Received notification for '${message.method}' from '${this.hostIdentifier}'`);\n\n\t\t\t// Forward the message content to all event listeners.\n\t\t\tthis.emit('notification', message);\n\n\t\t\t// Try to update the chain height.\n\t\t\tthis.updateChainHeightFromHeadersNotifications(message);\n\n\t\t\t// Return since it does not have an associated request resolver\n\t\t\treturn;\n\t\t}\n\n\t\t// If the response ID is null we cannot use it to index our request resolvers\n\t\tif(message.id === null)\n\t\t{\n\t\t\t// Throw an internal error, this should not happen.\n\t\t\tthrow(new Error('Internal error: Received an RPC response with ID null.'));\n\t\t}\n\n\t\t// Look up which request promise we should resolve this.\n\t\tconst requestResolver = this.requestResolvers[message.id];\n\n\t\t// If we do not have a request resolver for this response message..\n\t\tif(!requestResolver)\n\t\t{\n\t\t\t// Log that a message was ignored since the request has already been rejected.\n\t\t\tdebug.warning(`Ignoring response #${message.id} as the request has already been rejected.`);\n\n\t\t\t// Return as this has now been fully handled.\n\t\t\treturn;\n\t\t}\n\n\t\t// Remove the promise from the request list.\n\t\tdelete this.requestResolvers[message.id];\n\n\t\t// If the message contains an error..\n\t\tif(isRPCErrorResponse(message))\n\t\t{\n\t\t\t// Forward the message error to the request resolver and omit the `result` parameter.\n\t\t\trequestResolver(new Error(message.error.message));\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// Forward the message content to the request resolver and omit the `error` parameter\n\t\t\t// (by setting it to undefined).\n\t\t\trequestResolver(undefined, message.result);\n\n\t\t\t// Attempt to extract genesis hash from feature requests.\n\t\t\tthis.storeGenesisHashFromFeaturesResponse(message);\n\t\t}\n\t}\n\n\t/**\n\t * Callback function that is called when connection to the Electrum server is lost.\n\t * Aborts all active requests with an error message indicating that connection was lost.\n\t *\n\t * @ignore\n\t */\n\tasync onConnectionDisconnect(): Promise<void>\n\t{\n\t\t// Loop over active requests\n\t\tfor(const resolverId in this.requestResolvers)\n\t\t{\n\t\t\t// Extract request resolver for readability\n\t\t\tconst requestResolver = this.requestResolvers[resolverId];\n\n\t\t\t// Resolve the active request with an error indicating that the connection was lost.\n\t\t\trequestResolver(new Error('Connection lost'));\n\n\t\t\t// Remove the promise from the request list.\n\t\t\tdelete this.requestResolvers[resolverId];\n\t\t}\n\n\t\t// Synchronize with the underlying connection status.\n\t\tthis.handleConnectionStatusChanges('disconnected');\n\t}\n\n\t/**\n\t * Stores the server provider software version field on successful version negotiation.\n\t *\n\t * @ignore\n\t */\n\tasync storeSoftwareVersion(versionStatement): Promise<void>\n\t{\n\t\t// TODO: handle failed version negotiation better.\n\t\tif(versionStatement.error)\n\t\t{\n\t\t\t// Do nothing.\n\t\t\treturn;\n\t\t}\n\n\t\t// Store the software version.\n\t\tthis.software = versionStatement.software;\n\t}\n\n\t/**\n\t * Updates the last received timestamp.\n\t *\n\t * @ignore\n\t */\n\tasync updateLastReceivedTimestamp(): Promise<void>\n\t{\n\t\t// Update the timestamp for when we last received data.\n\t\tthis.lastReceivedTimestamp = Date.now();\n\t}\n\n\t/**\n\t * Checks if the provided message is a response to a headers subscription,\n\t * and if so updates the locally stored chain height value for this client.\n\t *\n\t * @ignore\n\t */\n\tasync updateChainHeightFromHeadersNotifications(message): Promise<void>\n\t{\n\t\t// If the message is a notification for a new chain height..\n\t\tif(message.method === 'blockchain.headers.subscribe')\n\t\t{\n\t\t\t// ..also store the updated chain height locally.\n\t\t\tthis.chainHeight = message.params[0].height;\n\t\t}\n\t}\n\n\t/**\n\t * Checks if the provided message is a response to a server.features request,\n\t * and if so stores the genesis hash for this client locally.\n\t *\n\t * @ignore\n\t */\n\tasync storeGenesisHashFromFeaturesResponse(message): Promise<void>\n\t{\n\t\ttry\n\t\t{\n\t\t\t// If the message is a response to a features request..\n\t\t\tif(typeof message.result.genesis_hash !== 'undefined')\n\t\t\t{\n\t\t\t\t// ..store the genesis hash locally.\n\t\t\t\tthis.genesisHash = message.result.genesis_hash;\n\t\t\t}\n\t\t}\n\t\tcatch (_ignored)\n\t\t{\n\t\t\t// Do nothing.\n\t\t}\n\t}\n\n\t/**\n\t * Helper function to synchronize state and events with the underlying connection.\n\t */\n\tasync handleConnectionStatusChanges(eventName): Promise<void>\n\t{\n\t\t// Re-emit the event.\n\t\tthis.emit(eventName);\n\t}\n\n\t// Add magic glue that makes typedoc happy so that we can have the events listed on the class.\n\tpublic readonly connecting: [];\n\tpublic readonly connected: [];\n\tpublic readonly disconnecting: [];\n\tpublic readonly disconnected: [];\n\tpublic readonly reconnecting: [];\n\tpublic readonly notification: [ RPCNotification ];\n\tpublic readonly error: [ Error ];\n}\n\n// Export the client.\nexport default ElectrumClient;\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@electrum-cash/network",
-  "version": "4.3.0",
+  "version": "4.3.1-development.16658117881",
   "description": "@electrum-cash/network is a lightweight JavaScript library that lets you connect with one or more Electrum servers.",
   "keywords": [
     "electrum",