@hiero-ledger/sdk 2.76.0 → 2.78.0-beta.1

package/lib/channel/NodeChannel.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeChannel.js","sources":["../../src/channel/NodeChannel.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nimport tls from \"tls\";\nimport { Client, credentials, Metadata } from \"@grpc/grpc-js\";\nimport Channel from \"./Channel.js\";\nimport GrpcServicesError from \"../grpc/GrpcServiceError.js\";\nimport GrpcStatus from \"../grpc/GrpcStatus.js\";\nimport { ALL_NETWORK_IPS } from \"../constants/ClientConstants.js\";\nimport { SDK_NAME, SDK_VERSION } from \"../version.js\";\n\n/** @type {{ [key: string]: Client }} */\nconst clientCache = {};\n\nexport default class NodeChannel extends Channel {\n    /**\n     * @internal\n     * @param {string} address\n     * @param {number=} maxExecutionTime\n     */\n    constructor(address, maxExecutionTime) {\n        super();\n\n        /** @type {Client | null} */\n        this._client = null;\n\n        this.address = address;\n        this.maxExecutionTime = maxExecutionTime;\n\n        const { ip, port } = this.parseAddress(address);\n        this.nodeIp = ip;\n        this.nodePort = port;\n    }\n\n    /**\n     * Convert certificate bytes to PEM format\n     * @param {Buffer} certBytes\n     * @returns {string}\n     */\n    bytesToPem(certBytes) {\n        const base64Cert = certBytes.toString(\"base64\");\n        const lines = base64Cert.match(/.{1,64}/g)?.join(\"\\n\") || \"\";\n        return `-----BEGIN CERTIFICATE-----\\n${lines}\\n-----END CERTIFICATE-----`;\n    }\n\n    /**\n     * Validates and parses an address in the \"IP:Port\" format.\n     * @param {string} address\n     * @returns {{ ip: string, port: string }}\n     */\n    parseAddress(address) {\n        const [ip, port] = address.split(\":\");\n        if (!ip || !port) {\n            throw new Error(\n                \"Invalid address format. Expected format: 'IP:Port'\",\n            );\n        }\n        return { ip, port };\n    }\n\n    /**\n     * Retrieve the server's certificate dynamically.\n     * @returns {Promise<string>}\n     */\n    async _retrieveCertificate() {\n        return new Promise((resolve, reject) => {\n            const socket = tls.connect(\n                {\n                    host: this.nodeIp,\n                    port: Number(this.nodePort),\n                    rejectUnauthorized: false,\n                },\n                () => {\n                    try {\n                        const cert = socket.getPeerCertificate();\n\n                        if (cert && cert.raw) {\n                            resolve(this.bytesToPem(cert.raw));\n                        } else {\n                            reject(new Error(\"No certificate retrieved.\"));\n                        }\n                    } catch (err) {\n                        reject(err);\n                    } finally {\n                        socket.end();\n                    }\n                },\n            );\n\n            socket.on(\"error\", reject);\n        });\n    }\n\n    /**\n     * Initialize the gRPC client\n     * @returns {Promise<void>}\n     */\n    async _initializeClient() {\n        if (clientCache[this.address]) {\n            this._client = clientCache[this.address];\n            return;\n        }\n\n        let security;\n        const options = {\n            \"grpc.ssl_target_name_override\": \"127.0.0.1\",\n            \"grpc.default_authority\": \"127.0.0.1\",\n            \"grpc.http_connect_creds\": \"0\",\n            \"grpc.keepalive_time_ms\": 100000,\n            \"grpc.keepalive_timeout_ms\": 10000,\n            \"grpc.keepalive_permit_without_calls\": 1,\n            \"grpc.enable_retries\": 1,\n        };\n\n        // If the port is 50212, use TLS\n        if (this.nodePort === \"50212\") {\n            const certificate = Buffer.from(await this._retrieveCertificate());\n\n            security = credentials.createSsl(certificate);\n        } else {\n            security = credentials.createInsecure();\n        }\n\n        this._client = new Client(this.address, security, options);\n\n        clientCache[this.address] = this._client;\n    }\n\n    /**\n     * @override\n     * @returns {void}\n     */\n    close() {\n        if (this._client) {\n            this._client.close();\n            delete clientCache[this.address];\n        }\n    }\n\n    /**\n     * @override\n     * @protected\n     * @param {string} serviceName\n     * @returns {import(\"protobufjs\").RPCImpl}\n     */\n    _createUnaryClient(serviceName) {\n        return (method, requestData, callback) => {\n            this._initializeClient()\n                .then(() => {\n                    const deadline = new Date();\n                    const milliseconds = this.maxExecutionTime\n                        ? this.maxExecutionTime\n                        : 10000;\n                    deadline.setMilliseconds(\n                        deadline.getMilliseconds() + milliseconds,\n                    );\n\n                    this._client?.waitForReady(deadline, (err) => {\n                        if (err) {\n                            callback(\n                                new GrpcServicesError(\n                                    GrpcStatus.Timeout,\n                                    // Added colons to the IP address to resolve a SonarCloud IP issue.\n                                    ALL_NETWORK_IPS[`${this.nodeIp}:`],\n                                ),\n                            );\n                        } else {\n                            // Create metadata with user agent\n                            const metadata = new Metadata();\n\n                            metadata.set(\n                                \"x-user-agent\",\n                                `${SDK_NAME}/${SDK_VERSION}`,\n                            );\n\n                            this._client?.makeUnaryRequest(\n                                `/proto.${serviceName}/${method.name}`,\n                                (value) => value,\n                                (value) => value,\n                                Buffer.from(requestData),\n                                metadata,\n                                (e, r) => {\n                                    callback(e, r);\n                                },\n                            );\n                        }\n                    });\n                })\n                .catch((err) => {\n                    if (err instanceof Error) {\n                        callback(err);\n                    } else {\n                        callback(new Error(\"An unexpected error occurred\"));\n                    }\n                });\n        };\n    }\n}\n"],"names":["clientCache","NodeChannel","Channel","constructor","address","maxExecutionTime","super","this","_client","ip","port","parseAddress","nodeIp","nodePort","bytesToPem","certBytes","base64Cert","toString","match","join","split","Error","_retrieveCertificate","Promise","resolve","reject","socket","tls","connect","host","Number","rejectUnauthorized","cert","getPeerCertificate","raw","err","end","on","_initializeClient","security","certificate","Buffer","from","credentials","createSsl","createInsecure","Client","close","_createUnaryClient","serviceName","method","requestData","callback","then","deadline","Date","milliseconds","setMilliseconds","getMilliseconds","waitForReady","GrpcServicesError","GrpcStatus","Timeout","ALL_NETWORK_IPS","metadata","Metadata","set","SDK_NAME","SDK_VERSION","makeUnaryRequest","name","value","e","r","catch"],"mappings":"iUAUA,MAAMA,EAAc,CAAE,EAEP,MAAMC,UAAoBC,EAMrC,WAAAC,CAAYC,EAASC,GACjBC,QAGAC,KAAKC,QAAU,KAEfD,KAAKH,QAAUA,EACfG,KAAKF,iBAAmBA,EAExB,MAAMI,GAAEA,EAAEC,KAAEA,GAASH,KAAKI,aAAaP,GACvCG,KAAKK,OAASH,EACdF,KAAKM,SAAWH,CACxB,CAOI,UAAAI,CAAWC,GACP,MAAMC,EAAaD,EAAUE,SAAS,UAEtC,MAAO,gCADOD,EAAWE,MAAM,aAAaC,KAAK,OAAS,+BAElE,CAOI,YAAAR,CAAaP,GACT,MAAOK,EAAIC,GAAQN,EAAQgB,MAAM,KACjC,IAAKX,IAAOC,EACR,MAAM,IAAIW,MACN,sDAGR,MAAO,CAAEZ,KAAIC,OACrB,CAMI,0BAAMY,GACF,OAAO,IAAIC,QAAQ,CAACC,EAASC,KACzB,MAAMC,EAASC,EAAIC,QACf,CACIC,KAAMtB,KAAKK,OACXF,KAAMoB,OAAOvB,KAAKM,UAClBkB,oBAAoB,GAExB,KACI,IACI,MAAMC,EAAON,EAAOO,qBAEhBD,GAAQA,EAAKE,IACbV,EAAQjB,KAAKO,WAAWkB,EAAKE,MAE7BT,EAAO,IAAIJ,MAAM,6BAExB,CAAC,MAAOc,GACLV,EAAOU,EAC/B,CAA8B,QACNT,EAAOU,KAC/B,IAIYV,EAAOW,GAAG,QAASZ,IAE/B,CAMI,uBAAMa,GACF,GAAItC,EAAYO,KAAKH,SAEjB,YADAG,KAAKC,QAAUR,EAAYO,KAAKH,UAIpC,IAAImC,EAYJ,GAAsB,UAAlBhC,KAAKM,SAAsB,CAC3B,MAAM2B,EAAcC,OAAOC,WAAWnC,KAAKe,wBAE3CiB,EAAWI,EAAYC,UAAUJ,EAC7C,MACYD,EAAWI,EAAYE,iBAG3BtC,KAAKC,QAAU,IAAIsC,EAAOvC,KAAKH,QAASmC,EAnBxB,CACZ,gCAAiC,YACjC,yBAA0B,YAC1B,0BAA2B,IAC3B,yBAA0B,IAC1B,4BAA6B,IAC7B,sCAAuC,EACvC,sBAAuB,IAc3BvC,EAAYO,KAAKH,SAAWG,KAAKC,OACzC,CAMI,KAAAuC,GACQxC,KAAKC,UACLD,KAAKC,QAAQuC,eACN/C,EAAYO,KAAKH,SAEpC,CAQI,kBAAA4C,CAAmBC,GACf,MAAO,CAACC,EAAQC,EAAaC,KACzB7C,KAAK+B,oBACAe,KAAK,KACF,MAAMC,EAAW,IAAIC,KACfC,EAAejD,KAAKF,iBACpBE,KAAKF,iBACL,IACNiD,EAASG,gBACLH,EAASI,kBAAoBF,GAGjCjD,KAAKC,SAASmD,aAAaL,EAAWnB,IAClC,GAAIA,EACAiB,EACI,IAAIQ,EACAC,EAAWC,QAEXC,EAAgB,GAAGxD,KAAKK,iBAG7B,CAEH,MAAMoD,EAAW,IAAIC,EAErBD,EAASE,IACL,eACA,GAAGC,KAAYC,KAGnB7D,KAAKC,SAAS6D,iBACV,UAAUpB,KAAeC,EAAOoB,OAC/BC,GAAUA,EACVA,GAAUA,EACX9B,OAAOC,KAAKS,GACZa,EACA,CAACQ,EAAGC,KACArB,EAASoB,EAAGC,IAGhD,MAGiBC,MAAOvC,IACAA,aAAed,MACf+B,EAASjB,GAETiB,EAAS,IAAI/B,MAAM,mCAI3C"}
+{"version":3,"file":"NodeChannel.js","sources":["../../src/channel/NodeChannel.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nimport tls from \"tls\";\nimport { Client, credentials, Metadata } from \"@grpc/grpc-js\";\nimport Channel from \"./Channel.js\";\nimport GrpcServicesError from \"../grpc/GrpcServiceError.js\";\nimport GrpcStatus from \"../grpc/GrpcStatus.js\";\nimport { ALL_NETWORK_IPS } from \"../constants/ClientConstants.js\";\nimport { SDK_NAME, SDK_VERSION } from \"../version.js\";\n\n/** @type {{ [key: string]: Client }} */\nconst clientCache = {};\n\nexport default class NodeChannel extends Channel {\n    /**\n     * @internal\n     * @param {string} address\n     * @param {number=} grpcDeadline\n     */\n    constructor(address, grpcDeadline) {\n        super(grpcDeadline);\n\n        /** @type {Client | null} */\n        this._client = null;\n\n        this.address = address;\n\n        const { ip, port } = this.parseAddress(address);\n        this.nodeIp = ip;\n        this.nodePort = port;\n    }\n\n    /**\n     * Convert certificate bytes to PEM format\n     * @param {Buffer} certBytes\n     * @returns {string}\n     */\n    bytesToPem(certBytes) {\n        const base64Cert = certBytes.toString(\"base64\");\n        const lines = base64Cert.match(/.{1,64}/g)?.join(\"\\n\") || \"\";\n        return `-----BEGIN CERTIFICATE-----\\n${lines}\\n-----END CERTIFICATE-----`;\n    }\n\n    /**\n     * Validates and parses an address in the \"IP:Port\" format.\n     * @param {string} address\n     * @returns {{ ip: string, port: string }}\n     */\n    parseAddress(address) {\n        const [ip, port] = address.split(\":\");\n        if (!ip || !port) {\n            throw new Error(\n                \"Invalid address format. Expected format: 'IP:Port'\",\n            );\n        }\n        return { ip, port };\n    }\n\n    /**\n     * Retrieve the server's certificate dynamically.\n     * @returns {Promise<string>}\n     */\n    async _retrieveCertificate() {\n        return new Promise((resolve, reject) => {\n            const socket = tls.connect(\n                {\n                    host: this.nodeIp,\n                    port: Number(this.nodePort),\n                    rejectUnauthorized: false,\n                },\n                () => {\n                    try {\n                        const cert = socket.getPeerCertificate();\n\n                        if (cert && cert.raw) {\n                            resolve(this.bytesToPem(cert.raw));\n                        } else {\n                            reject(new Error(\"No certificate retrieved.\"));\n                        }\n                    } catch (err) {\n                        reject(err);\n                    } finally {\n                        socket.end();\n                    }\n                },\n            );\n\n            socket.on(\"error\", reject);\n        });\n    }\n\n    /**\n     * Initialize the gRPC client\n     * @returns {Promise<void>}\n     */\n    async _initializeClient() {\n        if (clientCache[this.address]) {\n            this._client = clientCache[this.address];\n            return;\n        }\n\n        let security;\n        const options = {\n            \"grpc.ssl_target_name_override\": \"127.0.0.1\",\n            \"grpc.default_authority\": \"127.0.0.1\",\n            \"grpc.http_connect_creds\": \"0\",\n            \"grpc.keepalive_time_ms\": 100000,\n            \"grpc.keepalive_timeout_ms\": 10000,\n            \"grpc.keepalive_permit_without_calls\": 1,\n            \"grpc.enable_retries\": 1,\n        };\n\n        // If the port is 50212, use TLS\n        if (this.nodePort === \"50212\") {\n            const certificate = Buffer.from(await this._retrieveCertificate());\n\n            security = credentials.createSsl(certificate);\n        } else {\n            security = credentials.createInsecure();\n        }\n\n        this._client = new Client(this.address, security, options);\n\n        clientCache[this.address] = this._client;\n    }\n\n    /**\n     * @override\n     * @returns {void}\n     */\n    close() {\n        if (this._client) {\n            this._client.close();\n            delete clientCache[this.address];\n        }\n    }\n\n    /**\n     * @override\n     * @protected\n     * @param {string} serviceName\n     * @returns {import(\"protobufjs\").RPCImpl}\n     */\n    _createUnaryClient(serviceName) {\n        return (method, requestData, callback) => {\n            this._initializeClient()\n                .then(() => {\n                    const deadline = new Date();\n                    const milliseconds = this.grpcDeadline;\n                    deadline.setMilliseconds(\n                        deadline.getMilliseconds() + milliseconds,\n                    );\n\n                    this._client?.waitForReady(deadline, (err) => {\n                        if (err) {\n                            callback(\n                                new GrpcServicesError(\n                                    GrpcStatus.Timeout,\n                                    // Added colons to the IP address to resolve a SonarCloud IP issue.\n                                    ALL_NETWORK_IPS[`${this.nodeIp}:`],\n                                ),\n                            );\n                        } else {\n                            // Create metadata with user agent\n                            const metadata = new Metadata();\n\n                            metadata.set(\n                                \"x-user-agent\",\n                                `${SDK_NAME}/${SDK_VERSION}`,\n                            );\n\n                            this._client?.makeUnaryRequest(\n                                `/proto.${serviceName}/${method.name}`,\n                                (value) => value,\n                                (value) => value,\n                                Buffer.from(requestData),\n                                metadata,\n                                (e, r) => {\n                                    callback(e, r);\n                                },\n                            );\n                        }\n                    });\n                })\n                .catch((err) => {\n                    if (err instanceof Error) {\n                        callback(err);\n                    } else {\n                        callback(new Error(\"An unexpected error occurred\"));\n                    }\n                });\n        };\n    }\n}\n"],"names":["clientCache","NodeChannel","Channel","constructor","address","grpcDeadline","super","this","_client","ip","port","parseAddress","nodeIp","nodePort","bytesToPem","certBytes","base64Cert","toString","match","join","split","Error","_retrieveCertificate","Promise","resolve","reject","socket","tls","connect","host","Number","rejectUnauthorized","cert","getPeerCertificate","raw","err","end","on","_initializeClient","security","certificate","Buffer","from","credentials","createSsl","createInsecure","Client","close","_createUnaryClient","serviceName","method","requestData","callback","then","deadline","Date","milliseconds","setMilliseconds","getMilliseconds","waitForReady","GrpcServicesError","GrpcStatus","Timeout","ALL_NETWORK_IPS","metadata","Metadata","set","SDK_NAME","SDK_VERSION","makeUnaryRequest","name","value","e","r","catch"],"mappings":"iUAUA,MAAMA,EAAc,CAAE,EAEP,MAAMC,UAAoBC,EAMrC,WAAAC,CAAYC,EAASC,GACjBC,MAAMD,GAGNE,KAAKC,QAAU,KAEfD,KAAKH,QAAUA,EAEf,MAAMK,GAAEA,EAAEC,KAAEA,GAASH,KAAKI,aAAaP,GACvCG,KAAKK,OAASH,EACdF,KAAKM,SAAWH,CACxB,CAOI,UAAAI,CAAWC,GACP,MAAMC,EAAaD,EAAUE,SAAS,UAEtC,MAAO,gCADOD,EAAWE,MAAM,aAAaC,KAAK,OAAS,+BAElE,CAOI,YAAAR,CAAaP,GACT,MAAOK,EAAIC,GAAQN,EAAQgB,MAAM,KACjC,IAAKX,IAAOC,EACR,MAAM,IAAIW,MACN,sDAGR,MAAO,CAAEZ,KAAIC,OACrB,CAMI,0BAAMY,GACF,OAAO,IAAIC,QAAQ,CAACC,EAASC,KACzB,MAAMC,EAASC,EAAIC,QACf,CACIC,KAAMtB,KAAKK,OACXF,KAAMoB,OAAOvB,KAAKM,UAClBkB,oBAAoB,GAExB,KACI,IACI,MAAMC,EAAON,EAAOO,qBAEhBD,GAAQA,EAAKE,IACbV,EAAQjB,KAAKO,WAAWkB,EAAKE,MAE7BT,EAAO,IAAIJ,MAAM,6BAExB,CAAC,MAAOc,GACLV,EAAOU,EAC/B,CAA8B,QACNT,EAAOU,KAC/B,IAIYV,EAAOW,GAAG,QAASZ,IAE/B,CAMI,uBAAMa,GACF,GAAItC,EAAYO,KAAKH,SAEjB,YADAG,KAAKC,QAAUR,EAAYO,KAAKH,UAIpC,IAAImC,EAYJ,GAAsB,UAAlBhC,KAAKM,SAAsB,CAC3B,MAAM2B,EAAcC,OAAOC,WAAWnC,KAAKe,wBAE3CiB,EAAWI,EAAYC,UAAUJ,EAC7C,MACYD,EAAWI,EAAYE,iBAG3BtC,KAAKC,QAAU,IAAIsC,EAAOvC,KAAKH,QAASmC,EAnBxB,CACZ,gCAAiC,YACjC,yBAA0B,YAC1B,0BAA2B,IAC3B,yBAA0B,IAC1B,4BAA6B,IAC7B,sCAAuC,EACvC,sBAAuB,IAc3BvC,EAAYO,KAAKH,SAAWG,KAAKC,OACzC,CAMI,KAAAuC,GACQxC,KAAKC,UACLD,KAAKC,QAAQuC,eACN/C,EAAYO,KAAKH,SAEpC,CAQI,kBAAA4C,CAAmBC,GACf,MAAO,CAACC,EAAQC,EAAaC,KACzB7C,KAAK+B,oBACAe,KAAK,KACF,MAAMC,EAAW,IAAIC,KACfC,EAAejD,KAAKF,aAC1BiD,EAASG,gBACLH,EAASI,kBAAoBF,GAGjCjD,KAAKC,SAASmD,aAAaL,EAAWnB,IAClC,GAAIA,EACAiB,EACI,IAAIQ,EACAC,EAAWC,QAEXC,EAAgB,GAAGxD,KAAKK,iBAG7B,CAEH,MAAMoD,EAAW,IAAIC,EAErBD,EAASE,IACL,eACA,GAAGC,KAAYC,KAGnB7D,KAAKC,SAAS6D,iBACV,UAAUpB,KAAeC,EAAOoB,OAC/BC,GAAUA,EACVA,GAAUA,EACX9B,OAAOC,KAAKS,GACZa,EACA,CAACQ,EAAGC,KACArB,EAASoB,EAAGC,IAGhD,MAGiBC,MAAOvC,IACAA,aAAed,MACf+B,EAASjB,GAETiB,EAAS,IAAI/B,MAAM,mCAI3C"}

package/lib/channel/WebChannel.cjs

@@ -18,15 +18,161 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 class WebChannel extends _Channel.default {
   /**
    * @param {string} address
+   * @param {number=} grpcDeadline
    */
-  constructor(address) {
-    super();
+  constructor(address, grpcDeadline) {
+    super(grpcDeadline);
 
     /**
      * @type {string}
      * @private
      */
     this._address = address;
+
+    // Set the gRPC deadline using the base class method
+
+    /**
+     * Flag indicating if the connection is ready (health check has passed)
+     * Set to true after the first successful health check
+     *
+     * @type {boolean}
+     * @private
+     */
+    this._isReady = false;
+
+    /**
+     * Promise that resolves when the health check is complete
+     * Used to prevent multiple concurrent health checks
+     *
+     * @type {Promise<void>|null}
+     * @private
+     */
+    this._healthCheckPromise = null;
+  }
+
+  /**
+   * Determines whether to use HTTPS based on the address
+   * @param {string} address - The address to check
+   * @returns {boolean} - True if HTTPS should be used, false for HTTP
+   * @private
+   */
+  _shouldUseHttps(address) {
+    return !(address.includes("localhost") || address.includes("127.0.0.1"));
+  }
+
+  /**
+   * Builds the full URL with appropriate scheme (http/https)
+   * @param {string} address - The base address
+   * @returns {string} - The full URL with scheme
+   * @private
+   */
+  _buildUrl(address) {
+    // Check if address already contains a scheme
+    const hasScheme = address.startsWith("http://") || address.startsWith("https://");
+    if (hasScheme) {
+      // Use the address as-is if it already has a scheme
+      return address;
+    } else {
+      // Only prepend scheme if none exists
+      const shouldUseHttps = this._shouldUseHttps(address);
+      return shouldUseHttps ? `https://${address}` : `http://${address}`;
+    }
+  }
+
+  /**
+   * Check if the gRPC-Web proxy is reachable and healthy
+   * Performs a POST request and verifies the response has gRPC-Web headers,
+   * which indicates the proxy is running and processing gRPC requests.
+   * Results are cached per address for the entire lifecycle.
+   * Uses promise-based synchronization to prevent multiple concurrent health checks.
+   *
+   * @param {Date} deadline - Deadline for the health check
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _waitForReady(deadline) {
+    // Check if we've already validated this address
+    if (this._isReady) {
+      return; // Health check already passed for this address
+    }
+
+    // If a health check is already in progress, wait for it to complete
+    if (this._healthCheckPromise) {
+      return this._healthCheckPromise;
+    }
+
+    // Start a new health check and store the promise
+    this._healthCheckPromise = this._performHealthCheck(deadline);
+    try {
+      await this._healthCheckPromise;
+    } finally {
+      // Clear the promise when done (success or failure)
+      this._healthCheckPromise = null;
+    }
+  }
+
+  /**
+   * Performs the actual health check request
+   * @param {Date} deadline - Deadline for the health check
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _performHealthCheck(deadline) {
+    const address = this._buildUrl(this._address);
+
+    // Calculate remaining time until deadline
+    const timeoutMs = deadline.getTime() - Date.now();
+    if (timeoutMs <= 0) {
+      throw new _GrpcServiceError.default(_GrpcStatus.default.Timeout, _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());
+    }
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => abortController.abort(), timeoutMs);
+    try {
+      // Make a POST request to verify the gRPC-Web proxy is running
+      // We use a minimal gRPC-Web compatible request
+      //eslint-disable-next-line n/no-unsupported-features/node-builtins
+      const response = await fetch(address, {
+        method: "POST",
+        headers: {
+          "content-type": "application/grpc-web+proto",
+          "x-user-agent": `${_version.SDK_NAME}/${_version.SDK_VERSION}`,
+          "x-grpc-web": "1"
+        },
+        body: new Uint8Array(0),
+        // Empty body for health check
+        signal: abortController.signal
+      });
+      clearTimeout(timeoutId);
+
+      // Check if response is successful (200) or indicates a redirect (3xx)
+      // 3xx status codes indicate the resource has moved, which is valid for proxies
+      if (response.ok || response.status >= 300 && response.status < 400) {
+        const grpcStatus = response.headers.get("grpc-status");
+        const grpcMessage = response.headers.get("grpc-message");
+
+        // If gRPC headers exist, the proxy is running and processing requests
+        if (grpcStatus != null || grpcMessage != null) {
+          // Mark this connection as ready
+          this._isReady = true;
+          return; //  Healthy - gRPC-Web proxy is responding
+        }
+      }
+
+      // If we get here, either status isn't 200/3xx or no gRPC headers present
+      // This means the proxy might not be configured correctly or not running
+      throw new _GrpcServiceError.default(_GrpcStatus.default.Unavailable, _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new _GrpcServiceError.default(_GrpcStatus.default.Timeout, _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());
+      }
+      if (error instanceof _GrpcServiceError.default) {
+        throw error;
+      }
+
+      // Network error - server is not reachable
+      throw new _GrpcServiceError.default(_GrpcStatus.default.Unavailable, _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());
+    }
   }
 
   /**
@@ -46,18 +192,16 @@ class WebChannel extends _Channel.default {
   _createUnaryClient(serviceName) {
     // eslint-disable-next-line @typescript-eslint/no-misused-promises
     return async (method, requestData, callback) => {
+      // Calculate deadline for connection check
+      const deadline = new Date();
+      const milliseconds = this._grpcDeadline;
+      deadline.setMilliseconds(deadline.getMilliseconds() + milliseconds);
       try {
-        // Check if address already contains a scheme
-        const hasScheme = this._address.startsWith("http://") || this._address.startsWith("https://");
-        let address;
-        if (hasScheme) {
-          // Use the address as-is if it already has a scheme
-          address = this._address;
-        } else {
-          // Only prepend scheme if none exists
-          const shouldUseHttps = !(this._address.includes("localhost") || this._address.includes("127.0.0.1"));
-          address = shouldUseHttps ? `https://${this._address}` : `http://${this._address}`;
-        }
+        // Wait for connection to be ready (similar to gRPC waitForReady)
+        await this._waitForReady(deadline);
+
+        // Build the full URL with appropriate scheme
+        const address = this._buildUrl(this._address);
         // this will be executed in a browser environment so eslint is
         // disabled for the fetch call
         //eslint-disable-next-line n/no-unsupported-features/node-builtins
@@ -73,6 +217,7 @@ class WebChannel extends _Channel.default {
         if (!response.ok) {
           const error = new _HttpError.default(_HttpStatus.default._fromValue(response.status));
           callback(error, null);
+          return;
         }
 
         // Check headers for gRPC errors
@@ -82,11 +227,16 @@ class WebChannel extends _Channel.default {
           const error = new _GrpcServiceError.default(_GrpcStatus.default._fromValue(parseInt(grpcStatus)), _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());
           error.message = grpcMessage;
           callback(error, null);
+          return;
         }
         const responseBuffer = await response.arrayBuffer();
         const unaryResponse = (0, _Channel.decodeUnaryResponse)(responseBuffer);
         callback(null, unaryResponse);
       } catch (error) {
+        if (error instanceof _GrpcServiceError.default) {
+          callback(error, null);
+          return;
+        }
         const err = new _GrpcServiceError.default(
         // retry on grpc web errors
         _GrpcStatus.default._fromValue(18), _ClientConstants.ALL_WEB_NETWORK_NODES?.[this._address]?.toString());

package/lib/channel/WebChannel.d.ts

@@ -1,12 +1,62 @@
 export default class WebChannel extends Channel {
     /**
      * @param {string} address
+     * @param {number=} grpcDeadline
      */
-    constructor(address: string);
+    constructor(address: string, grpcDeadline?: number | undefined);
     /**
      * @type {string}
      * @private
      */
     private _address;
+    /**
+     * Flag indicating if the connection is ready (health check has passed)
+     * Set to true after the first successful health check
+     *
+     * @type {boolean}
+     * @private
+     */
+    private _isReady;
+    /**
+     * Promise that resolves when the health check is complete
+     * Used to prevent multiple concurrent health checks
+     *
+     * @type {Promise<void>|null}
+     * @private
+     */
+    private _healthCheckPromise;
+    /**
+     * Determines whether to use HTTPS based on the address
+     * @param {string} address - The address to check
+     * @returns {boolean} - True if HTTPS should be used, false for HTTP
+     * @private
+     */
+    private _shouldUseHttps;
+    /**
+     * Builds the full URL with appropriate scheme (http/https)
+     * @param {string} address - The base address
+     * @returns {string} - The full URL with scheme
+     * @private
+     */
+    private _buildUrl;
+    /**
+     * Check if the gRPC-Web proxy is reachable and healthy
+     * Performs a POST request and verifies the response has gRPC-Web headers,
+     * which indicates the proxy is running and processing gRPC requests.
+     * Results are cached per address for the entire lifecycle.
+     * Uses promise-based synchronization to prevent multiple concurrent health checks.
+     *
+     * @param {Date} deadline - Deadline for the health check
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _waitForReady;
+    /**
+     * Performs the actual health check request
+     * @param {Date} deadline - Deadline for the health check
+     * @returns {Promise<void>}
+     * @private
+     */
+    private _performHealthCheck;
 }
 import Channel from "./Channel.js";

package/lib/channel/WebChannel.js

@@ -1,2 +1,2 @@
-import{ALL_WEB_NETWORK_NODES as t}from"../constants/ClientConstants.js";import s from"../grpc/GrpcServiceError.js";import r from"../grpc/GrpcStatus.js";import e from"../http/HttpError.js";import a from"../http/HttpStatus.js";import{SDK_NAME as o,SDK_VERSION as n}from"../version.js";import i,{encodeRequest as p,decodeUnaryResponse as d}from"./Channel.js";class c extends i{constructor(t){super(),this._address=t}close(){}_createUnaryClient(i){return async(c,l,h)=>{try{let m;if(this._address.startsWith("http://")||this._address.startsWith("https://"))m=this._address;else{m=!(this._address.includes("localhost")||this._address.includes("127.0.0.1"))?`https://${this._address}`:`http://${this._address}`}const u=await fetch(`${m}/proto.${i}/${c.name}`,{method:"POST",headers:{"content-type":"application/grpc-web+proto","x-user-agent":`${o}/${n}`,"x-grpc-web":"1"},body:p(l)});if(!u.ok){h(new e(a._fromValue(u.status)),null)}const f=u.headers.get("grpc-status"),_=u.headers.get("grpc-message");if(null!=f&&null!=_){const e=new s(r._fromValue(parseInt(f)),t?.[this._address]?.toString());e.message=_,h(e,null)}const g=await u.arrayBuffer();h(null,d(g))}catch(e){h(new s(r._fromValue(18),t?.[this._address]?.toString()),null)}}}}export{c as default};
+import{ALL_WEB_NETWORK_NODES as t}from"../constants/ClientConstants.js";import e from"../grpc/GrpcServiceError.js";import s from"../grpc/GrpcStatus.js";import r from"../http/HttpError.js";import i from"../http/HttpStatus.js";import{SDK_NAME as a,SDK_VERSION as o}from"../version.js";import n,{encodeRequest as h,decodeUnaryResponse as l}from"./Channel.js";class c extends n{constructor(t,e){super(e),this._address=t,this._isReady=!1,this._healthCheckPromise=null}_shouldUseHttps(t){return!(t.includes("localhost")||t.includes("127.0.0.1"))}_buildUrl(t){if(t.startsWith("http://")||t.startsWith("https://"))return t;return this._shouldUseHttps(t)?`https://${t}`:`http://${t}`}async _waitForReady(t){if(!this._isReady){if(this._healthCheckPromise)return this._healthCheckPromise;this._healthCheckPromise=this._performHealthCheck(t);try{await this._healthCheckPromise}finally{this._healthCheckPromise=null}}}async _performHealthCheck(r){const i=this._buildUrl(this._address),n=r.getTime()-Date.now();if(n<=0)throw new e(s.Timeout,t?.[this._address]?.toString());const h=new AbortController,l=setTimeout(()=>h.abort(),n);try{const r=await fetch(i,{method:"POST",headers:{"content-type":"application/grpc-web+proto","x-user-agent":`${a}/${o}`,"x-grpc-web":"1"},body:new Uint8Array(0),signal:h.signal});if(clearTimeout(l),r.ok||r.status>=300&&r.status<400){const t=r.headers.get("grpc-status"),e=r.headers.get("grpc-message");if(null!=t||null!=e)return void(this._isReady=!0)}throw new e(s.Unavailable,t?.[this._address]?.toString())}catch(r){if(clearTimeout(l),r instanceof Error&&"AbortError"===r.name)throw new e(s.Timeout,t?.[this._address]?.toString());if(r instanceof e)throw r;throw new e(s.Unavailable,t?.[this._address]?.toString())}}close(){}_createUnaryClient(n){return async(c,d,u)=>{const p=new Date,m=this._grpcDeadline;p.setMilliseconds(p.getMilliseconds()+m);try{await this._waitForReady(p);const m=this._buildUrl(this._address),f=await fetch(`${m}/proto.${n}/${c.name}`,{method:"POST",headers:{"content-type":"application/grpc-web+proto","x-user-agent":`${a}/${o}`,"x-grpc-web":"1"},body:h(d)});if(!f.ok){return void u(new r(i._fromValue(f.status)),null)}const _=f.headers.get("grpc-status"),g=f.headers.get("grpc-message");if(null!=_&&null!=g){const r=new e(s._fromValue(parseInt(_)),t?.[this._address]?.toString());return r.message=g,void u(r,null)}const w=await f.arrayBuffer();u(null,l(w))}catch(r){if(r instanceof e)return void u(r,null);u(new e(s._fromValue(18),t?.[this._address]?.toString()),null)}}}}export{c as default};
 //# sourceMappingURL=WebChannel.js.map

package/lib/channel/WebChannel.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebChannel.js","sources":["../../src/channel/WebChannel.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nimport { ALL_WEB_NETWORK_NODES } from \"../constants/ClientConstants.js\";\nimport GrpcServiceError from \"../grpc/GrpcServiceError.js\";\nimport GrpcStatus from \"../grpc/GrpcStatus.js\";\nimport HttpError from \"../http/HttpError.js\";\nimport HttpStatus from \"../http/HttpStatus.js\";\nimport { SDK_NAME, SDK_VERSION } from \"../version.js\";\nimport Channel, { encodeRequest, decodeUnaryResponse } from \"./Channel.js\";\n\nexport default class WebChannel extends Channel {\n    /**\n     * @param {string} address\n     */\n    constructor(address) {\n        super();\n\n        /**\n         * @type {string}\n         * @private\n         */\n        this._address = address;\n    }\n\n    /**\n     * @override\n     * @returns {void}\n     */\n    close() {\n        // do nothing\n    }\n\n    /**\n     * @override\n     * @protected\n     * @param {string} serviceName\n     * @returns {import(\"protobufjs\").RPCImpl}\n     */\n    _createUnaryClient(serviceName) {\n        // eslint-disable-next-line @typescript-eslint/no-misused-promises\n        return async (method, requestData, callback) => {\n            try {\n                // Check if address already contains a scheme\n                const hasScheme =\n                    this._address.startsWith(\"http://\") ||\n                    this._address.startsWith(\"https://\");\n\n                let address;\n                if (hasScheme) {\n                    // Use the address as-is if it already has a scheme\n                    address = this._address;\n                } else {\n                    // Only prepend scheme if none exists\n                    const shouldUseHttps = !(\n                        this._address.includes(\"localhost\") ||\n                        this._address.includes(\"127.0.0.1\")\n                    );\n\n                    address = shouldUseHttps\n                        ? `https://${this._address}`\n                        : `http://${this._address}`;\n                }\n                // this will be executed in a browser environment so eslint is\n                // disabled for the fetch call\n                //eslint-disable-next-line n/no-unsupported-features/node-builtins\n                const response = await fetch(\n                    `${address}/proto.${serviceName}/${method.name}`,\n                    {\n                        method: \"POST\",\n                        headers: {\n                            \"content-type\": \"application/grpc-web+proto\",\n                            \"x-user-agent\": `${SDK_NAME}/${SDK_VERSION}`,\n                            \"x-grpc-web\": \"1\",\n                        },\n                        body: encodeRequest(requestData),\n                    },\n                );\n\n                if (!response.ok) {\n                    const error = new HttpError(\n                        HttpStatus._fromValue(response.status),\n                    );\n                    callback(error, null);\n                }\n\n                // Check headers for gRPC errors\n                const grpcStatus = response.headers.get(\"grpc-status\");\n                const grpcMessage = response.headers.get(\"grpc-message\");\n\n                if (grpcStatus != null && grpcMessage != null) {\n                    const error = new GrpcServiceError(\n                        GrpcStatus._fromValue(parseInt(grpcStatus)),\n                        ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n                    );\n                    error.message = grpcMessage;\n                    callback(error, null);\n                }\n\n                const responseBuffer = await response.arrayBuffer();\n                const unaryResponse = decodeUnaryResponse(responseBuffer);\n\n                callback(null, unaryResponse);\n            } catch (error) {\n                const err = new GrpcServiceError(\n                    // retry on grpc web errors\n                    GrpcStatus._fromValue(18),\n                    ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n                );\n                callback(err, null);\n            }\n        };\n    }\n}\n"],"names":["WebChannel","Channel","constructor","address","super","this","_address","close","_createUnaryClient","serviceName","async","method","requestData","callback","startsWith","includes","response","fetch","name","headers","SDK_NAME","SDK_VERSION","body","encodeRequest","ok","HttpError","HttpStatus","_fromValue","status","grpcStatus","get","grpcMessage","error","GrpcServiceError","GrpcStatus","parseInt","ALL_WEB_NETWORK_NODES","toString","message","responseBuffer","arrayBuffer","decodeUnaryResponse"],"mappings":"oWASe,MAAMA,UAAmBC,EAIpC,WAAAC,CAAYC,GACRC,QAMAC,KAAKC,SAAWH,CACxB,CAMI,KAAAI,GAEJ,CAQI,kBAAAC,CAAmBC,GAEf,OAAOC,MAAOC,EAAQC,EAAaC,KAC/B,IAMI,IAAIV,EACJ,GAJIE,KAAKC,SAASQ,WAAW,YACzBT,KAAKC,SAASQ,WAAW,YAKzBX,EAAUE,KAAKC,aACZ,CAOHH,IAJIE,KAAKC,SAASS,SAAS,cACvBV,KAAKC,SAASS,SAAS,cAIrB,WAAWV,KAAKC,WAChB,UAAUD,KAAKC,UACzC,CAIgB,MAAMU,QAAiBC,MACnB,GAAGd,WAAiBM,KAAeE,EAAOO,OAC1C,CACIP,OAAQ,OACRQ,QAAS,CACL,eAAgB,6BAChB,eAAgB,GAAGC,KAAYC,IAC/B,aAAc,KAElBC,KAAMC,EAAcX,KAI5B,IAAKI,EAASQ,GAAI,CAIdX,EAHc,IAAIY,EACdC,EAAWC,WAAWX,EAASY,SAEnB,KACpC,CAGgB,MAAMC,EAAab,EAASG,QAAQW,IAAI,eAClCC,EAAcf,EAASG,QAAQW,IAAI,gBAEzC,GAAkB,MAAdD,GAAqC,MAAfE,EAAqB,CAC3C,MAAMC,EAAQ,IAAIC,EACdC,EAAWP,WAAWQ,SAASN,IAC/BO,IAAwB/B,KAAKC,WAAW+B,YAE5CL,EAAMM,QAAUP,EAChBlB,EAASmB,EAAO,KACpC,CAEgB,MAAMO,QAAuBvB,EAASwB,cAGtC3B,EAAS,KAFa4B,EAAoBF,GAG7C,CAAC,MAAOP,GAMLnB,EALY,IAAIoB,EAEZC,EAAWP,WAAW,IACtBS,IAAwB/B,KAAKC,WAAW+B,YAE9B,KAC9B,EAEA"}
+{"version":3,"file":"WebChannel.js","sources":["../../src/channel/WebChannel.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nimport { ALL_WEB_NETWORK_NODES } from \"../constants/ClientConstants.js\";\nimport GrpcServiceError from \"../grpc/GrpcServiceError.js\";\nimport GrpcStatus from \"../grpc/GrpcStatus.js\";\nimport HttpError from \"../http/HttpError.js\";\nimport HttpStatus from \"../http/HttpStatus.js\";\nimport { SDK_NAME, SDK_VERSION } from \"../version.js\";\nimport Channel, { encodeRequest, decodeUnaryResponse } from \"./Channel.js\";\n\nexport default class WebChannel extends Channel {\n    /**\n     * @param {string} address\n     * @param {number=} grpcDeadline\n     */\n    constructor(address, grpcDeadline) {\n        super(grpcDeadline);\n\n        /**\n         * @type {string}\n         * @private\n         */\n        this._address = address;\n\n        // Set the gRPC deadline using the base class method\n\n        /**\n         * Flag indicating if the connection is ready (health check has passed)\n         * Set to true after the first successful health check\n         *\n         * @type {boolean}\n         * @private\n         */\n        this._isReady = false;\n\n        /**\n         * Promise that resolves when the health check is complete\n         * Used to prevent multiple concurrent health checks\n         *\n         * @type {Promise<void>|null}\n         * @private\n         */\n        this._healthCheckPromise = null;\n    }\n\n    /**\n     * Determines whether to use HTTPS based on the address\n     * @param {string} address - The address to check\n     * @returns {boolean} - True if HTTPS should be used, false for HTTP\n     * @private\n     */\n    _shouldUseHttps(address) {\n        return !(\n            address.includes(\"localhost\") || address.includes(\"127.0.0.1\")\n        );\n    }\n\n    /**\n     * Builds the full URL with appropriate scheme (http/https)\n     * @param {string} address - The base address\n     * @returns {string} - The full URL with scheme\n     * @private\n     */\n    _buildUrl(address) {\n        // Check if address already contains a scheme\n        const hasScheme =\n            address.startsWith(\"http://\") || address.startsWith(\"https://\");\n\n        if (hasScheme) {\n            // Use the address as-is if it already has a scheme\n            return address;\n        } else {\n            // Only prepend scheme if none exists\n            const shouldUseHttps = this._shouldUseHttps(address);\n            return shouldUseHttps ? `https://${address}` : `http://${address}`;\n        }\n    }\n\n    /**\n     * Check if the gRPC-Web proxy is reachable and healthy\n     * Performs a POST request and verifies the response has gRPC-Web headers,\n     * which indicates the proxy is running and processing gRPC requests.\n     * Results are cached per address for the entire lifecycle.\n     * Uses promise-based synchronization to prevent multiple concurrent health checks.\n     *\n     * @param {Date} deadline - Deadline for the health check\n     * @returns {Promise<void>}\n     * @private\n     */\n    async _waitForReady(deadline) {\n        // Check if we've already validated this address\n        if (this._isReady) {\n            return; // Health check already passed for this address\n        }\n\n        // If a health check is already in progress, wait for it to complete\n        if (this._healthCheckPromise) {\n            return this._healthCheckPromise;\n        }\n\n        // Start a new health check and store the promise\n        this._healthCheckPromise = this._performHealthCheck(deadline);\n\n        try {\n            await this._healthCheckPromise;\n        } finally {\n            // Clear the promise when done (success or failure)\n            this._healthCheckPromise = null;\n        }\n    }\n\n    /**\n     * Performs the actual health check request\n     * @param {Date} deadline - Deadline for the health check\n     * @returns {Promise<void>}\n     * @private\n     */\n    async _performHealthCheck(deadline) {\n        const address = this._buildUrl(this._address);\n\n        // Calculate remaining time until deadline\n        const timeoutMs = deadline.getTime() - Date.now();\n        if (timeoutMs <= 0) {\n            throw new GrpcServiceError(\n                GrpcStatus.Timeout,\n                ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n            );\n        }\n\n        const abortController = new AbortController();\n        const timeoutId = setTimeout(() => abortController.abort(), timeoutMs);\n\n        try {\n            // Make a POST request to verify the gRPC-Web proxy is running\n            // We use a minimal gRPC-Web compatible request\n            //eslint-disable-next-line n/no-unsupported-features/node-builtins\n            const response = await fetch(address, {\n                method: \"POST\",\n                headers: {\n                    \"content-type\": \"application/grpc-web+proto\",\n                    \"x-user-agent\": `${SDK_NAME}/${SDK_VERSION}`,\n                    \"x-grpc-web\": \"1\",\n                },\n                body: new Uint8Array(0), // Empty body for health check\n                signal: abortController.signal,\n            });\n\n            clearTimeout(timeoutId);\n\n            // Check if response is successful (200) or indicates a redirect (3xx)\n            // 3xx status codes indicate the resource has moved, which is valid for proxies\n            if (\n                response.ok ||\n                (response.status >= 300 && response.status < 400)\n            ) {\n                const grpcStatus = response.headers.get(\"grpc-status\");\n                const grpcMessage = response.headers.get(\"grpc-message\");\n\n                // If gRPC headers exist, the proxy is running and processing requests\n                if (grpcStatus != null || grpcMessage != null) {\n                    // Mark this connection as ready\n                    this._isReady = true;\n                    return; //  Healthy - gRPC-Web proxy is responding\n                }\n            }\n\n            // If we get here, either status isn't 200/3xx or no gRPC headers present\n            // This means the proxy might not be configured correctly or not running\n            throw new GrpcServiceError(\n                GrpcStatus.Unavailable,\n                ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n            );\n        } catch (error) {\n            clearTimeout(timeoutId);\n\n            if (error instanceof Error && error.name === \"AbortError\") {\n                throw new GrpcServiceError(\n                    GrpcStatus.Timeout,\n                    ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n                );\n            }\n\n            if (error instanceof GrpcServiceError) {\n                throw error;\n            }\n\n            // Network error - server is not reachable\n            throw new GrpcServiceError(\n                GrpcStatus.Unavailable,\n                ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n            );\n        }\n    }\n\n    /**\n     * @override\n     * @returns {void}\n     */\n    close() {\n        // do nothing\n    }\n\n    /**\n     * @override\n     * @protected\n     * @param {string} serviceName\n     * @returns {import(\"protobufjs\").RPCImpl}\n     */\n    _createUnaryClient(serviceName) {\n        // eslint-disable-next-line @typescript-eslint/no-misused-promises\n        return async (method, requestData, callback) => {\n            // Calculate deadline for connection check\n            const deadline = new Date();\n            const milliseconds = this._grpcDeadline;\n\n            deadline.setMilliseconds(deadline.getMilliseconds() + milliseconds);\n\n            try {\n                // Wait for connection to be ready (similar to gRPC waitForReady)\n                await this._waitForReady(deadline);\n\n                // Build the full URL with appropriate scheme\n                const address = this._buildUrl(this._address);\n                // this will be executed in a browser environment so eslint is\n                // disabled for the fetch call\n                //eslint-disable-next-line n/no-unsupported-features/node-builtins\n                const response = await fetch(\n                    `${address}/proto.${serviceName}/${method.name}`,\n                    {\n                        method: \"POST\",\n                        headers: {\n                            \"content-type\": \"application/grpc-web+proto\",\n                            \"x-user-agent\": `${SDK_NAME}/${SDK_VERSION}`,\n                            \"x-grpc-web\": \"1\",\n                        },\n                        body: encodeRequest(requestData),\n                    },\n                );\n\n                if (!response.ok) {\n                    const error = new HttpError(\n                        HttpStatus._fromValue(response.status),\n                    );\n                    callback(error, null);\n                    return;\n                }\n\n                // Check headers for gRPC errors\n                const grpcStatus = response.headers.get(\"grpc-status\");\n                const grpcMessage = response.headers.get(\"grpc-message\");\n\n                if (grpcStatus != null && grpcMessage != null) {\n                    const error = new GrpcServiceError(\n                        GrpcStatus._fromValue(parseInt(grpcStatus)),\n                        ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n                    );\n                    error.message = grpcMessage;\n                    callback(error, null);\n                    return;\n                }\n\n                const responseBuffer = await response.arrayBuffer();\n                const unaryResponse = decodeUnaryResponse(responseBuffer);\n\n                callback(null, unaryResponse);\n            } catch (error) {\n                if (error instanceof GrpcServiceError) {\n                    callback(error, null);\n                    return;\n                }\n\n                const err = new GrpcServiceError(\n                    // retry on grpc web errors\n                    GrpcStatus._fromValue(18),\n                    ALL_WEB_NETWORK_NODES?.[this._address]?.toString(),\n                );\n                callback(err, null);\n            }\n        };\n    }\n}\n"],"names":["WebChannel","Channel","constructor","address","grpcDeadline","super","this","_address","_isReady","_healthCheckPromise","_shouldUseHttps","includes","_buildUrl","startsWith","_waitForReady","deadline","_performHealthCheck","timeoutMs","getTime","Date","now","GrpcServiceError","GrpcStatus","Timeout","ALL_WEB_NETWORK_NODES","toString","abortController","AbortController","timeoutId","setTimeout","abort","response","fetch","method","headers","SDK_NAME","SDK_VERSION","body","Uint8Array","signal","clearTimeout","ok","status","grpcStatus","get","grpcMessage","Unavailable","error","Error","name","close","_createUnaryClient","serviceName","async","requestData","callback","milliseconds","_grpcDeadline","setMilliseconds","getMilliseconds","encodeRequest","HttpError","HttpStatus","_fromValue","parseInt","message","responseBuffer","arrayBuffer","decodeUnaryResponse"],"mappings":"oWASe,MAAMA,UAAmBC,EAKpC,WAAAC,CAAYC,EAASC,GACjBC,MAAMD,GAMNE,KAAKC,SAAWJ,EAWhBG,KAAKE,UAAW,EAShBF,KAAKG,oBAAsB,IACnC,CAQI,eAAAC,CAAgBP,GACZ,QACIA,EAAQQ,SAAS,cAAgBR,EAAQQ,SAAS,aAE9D,CAQI,SAAAC,CAAUT,GAKN,GAFIA,EAAQU,WAAW,YAAcV,EAAQU,WAAW,YAIpD,OAAOV,EAIP,OADuBG,KAAKI,gBAAgBP,GACpB,WAAWA,IAAY,UAAUA,GAErE,CAaI,mBAAMW,CAAcC,GAEhB,IAAIT,KAAKE,SAAT,CAKA,GAAIF,KAAKG,oBACL,OAAOH,KAAKG,oBAIhBH,KAAKG,oBAAsBH,KAAKU,oBAAoBD,GAEpD,UACUT,KAAKG,mBACvB,CAAkB,QAENH,KAAKG,oBAAsB,IACvC,CAfA,CAgBA,CAQI,yBAAMO,CAAoBD,GACtB,MAAMZ,EAAUG,KAAKM,UAAUN,KAAKC,UAG9BU,EAAYF,EAASG,UAAYC,KAAKC,MAC5C,GAAIH,GAAa,EACb,MAAM,IAAII,EACNC,EAAWC,QACXC,IAAwBlB,KAAKC,WAAWkB,YAIhD,MAAMC,EAAkB,IAAIC,gBACtBC,EAAYC,WAAW,IAAMH,EAAgBI,QAASb,GAE5D,IAII,MAAMc,QAAiBC,MAAM7B,EAAS,CAClC8B,OAAQ,OACRC,QAAS,CACL,eAAgB,6BAChB,eAAgB,GAAGC,KAAYC,IAC/B,aAAc,KAElBC,KAAM,IAAIC,WAAW,GACrBC,OAAQb,EAAgBa,SAO5B,GAJAC,aAAaZ,GAKTG,EAASU,IACRV,EAASW,QAAU,KAAOX,EAASW,OAAS,IAC/C,CACE,MAAMC,EAAaZ,EAASG,QAAQU,IAAI,eAClCC,EAAcd,EAASG,QAAQU,IAAI,gBAGzC,GAAkB,MAAdD,GAAqC,MAAfE,EAGtB,YADAvC,KAAKE,UAAW,EAGpC,CAIY,MAAM,IAAIa,EACNC,EAAWwB,YACXtB,IAAwBlB,KAAKC,WAAWkB,WAE/C,CAAC,MAAOsB,GAGL,GAFAP,aAAaZ,GAETmB,aAAiBC,OAAwB,eAAfD,EAAME,KAChC,MAAM,IAAI5B,EACNC,EAAWC,QACXC,IAAwBlB,KAAKC,WAAWkB,YAIhD,GAAIsB,aAAiB1B,EACjB,MAAM0B,EAIV,MAAM,IAAI1B,EACNC,EAAWwB,YACXtB,IAAwBlB,KAAKC,WAAWkB,WAExD,CACA,CAMI,KAAAyB,GAEJ,CAQI,kBAAAC,CAAmBC,GAEf,OAAOC,MAAOpB,EAAQqB,EAAaC,KAE/B,MAAMxC,EAAW,IAAII,KACfqC,EAAelD,KAAKmD,cAE1B1C,EAAS2C,gBAAgB3C,EAAS4C,kBAAoBH,GAEtD,UAEUlD,KAAKQ,cAAcC,GAGzB,MAAMZ,EAAUG,KAAKM,UAAUN,KAAKC,UAI9BwB,QAAiBC,MACnB,GAAG7B,WAAiBiD,KAAenB,EAAOgB,OAC1C,CACIhB,OAAQ,OACRC,QAAS,CACL,eAAgB,6BAChB,eAAgB,GAAGC,KAAYC,IAC/B,aAAc,KAElBC,KAAMuB,EAAcN,KAI5B,IAAKvB,EAASU,GAAI,CAKd,YADAc,EAHc,IAAIM,EACdC,EAAWC,WAAWhC,EAASW,SAEnB,KAEpC,CAGgB,MAAMC,EAAaZ,EAASG,QAAQU,IAAI,eAClCC,EAAcd,EAASG,QAAQU,IAAI,gBAEzC,GAAkB,MAAdD,GAAqC,MAAfE,EAAqB,CAC3C,MAAME,EAAQ,IAAI1B,EACdC,EAAWyC,WAAWC,SAASrB,IAC/BnB,IAAwBlB,KAAKC,WAAWkB,YAI5C,OAFAsB,EAAMkB,QAAUpB,OAChBU,EAASR,EAAO,KAEpC,CAEgB,MAAMmB,QAAuBnC,EAASoC,cAGtCZ,EAAS,KAFaa,EAAoBF,GAG7C,CAAC,MAAOnB,GACL,GAAIA,aAAiB1B,EAEjB,YADAkC,EAASR,EAAO,MASpBQ,EALY,IAAIlC,EAEZC,EAAWyC,WAAW,IACtBvC,IAAwBlB,KAAKC,WAAWkB,YAE9B,KAC9B,EAEA"}

package/lib/client/Client.cjs

@@ -16,6 +16,7 @@ var _FileId = _interopRequireDefault(require("../file/FileId.cjs"));
 var _Logger = _interopRequireDefault(require("../logger/Logger.cjs"));
 var _util = require("../util.cjs");
 var _AddressBookQuery = _interopRequireDefault(require("../network/AddressBookQuery.cjs"));
+var _ClientConstants = require("../constants/ClientConstants.cjs");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 // SPDX-License-Identifier: Apache-2.0
 
@@ -48,6 +49,8 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  * @property {boolean} [scheduleNetworkUpdate]
  * @property {number} [shard]
  * @property {number} [realm]
+ * @property {number} [grpcDeadline]
+ * @property {number} [requestTimeout]
  */
 
 /**
@@ -129,7 +132,10 @@ class Client {
     this._defaultRegenerateTransactionId = true;
 
     /** @private */
-    this._requestTimeout = null;
+    this._requestTimeout = _ClientConstants.DEFAULT_REQUEST_TIMEOUT;
+
+    /** @private */
+    this._grpcDeadline = _ClientConstants.DEFAULT_GRPC_DEADLINE;
 
     /**
      * @type {boolean}
@@ -152,6 +158,17 @@ class Client {
     if (props != null && props.realm != null) {
       this._realm = props.realm;
     }
+    if (props != null && props.grpcDeadline != null) {
+      this.setGrpcDeadline(props.grpcDeadline);
+    }
+    if (props != null && props.requestTimeout != null) {
+      this.setRequestTimeout(props.requestTimeout);
+    }
+
+    // Validate that requestTimeout is larger than grpcDeadline after both are set
+    if (this._requestTimeout <= this._grpcDeadline) {
+      console.warn(`DEPRECATION WARNING: requestTimeout (${this._requestTimeout}ms) should be larger than grpcDeadline (${this._grpcDeadline}ms). ` + `This configuration may cause operations to fail unexpectedly. ` + `This will throw an error in the next major version. Please adjust your timeout values.`);
+    }
 
     /** @internal */
     /** @type {NodeJS.Timeout} */
@@ -649,21 +666,57 @@ class Client {
   }
 
   /**
-   * @param {number} requestTimeout - Number of milliseconds
+   * Set the total request timeout for complete operations.
+   *
+   * @param {number} requestTimeout - Maximum time in milliseconds for complete Transaction/Query operations
    * @returns {this}
    */
   setRequestTimeout(requestTimeout) {
+    if (requestTimeout <= 0) {
+      throw new Error("requestTimeout must be a positive number");
+    }
+    if (requestTimeout <= this._grpcDeadline) {
+      console.warn(`DEPRECATION WARNING: requestTimeout (${requestTimeout}ms) should be larger than grpcDeadline (${this._grpcDeadline}ms). ` + `This configuration may cause operations to fail unexpectedly. ` + `This will throw an error in the next major version. Please adjust your timeout values.`);
+    }
     this._requestTimeout = requestTimeout;
     return this;
   }
 
   /**
-   * @returns {?number}
+   * Get the total request timeout for complete operations.
+   *
+   * @returns {number} Maximum time in milliseconds for complete Transaction/Query operations
    */
   get requestTimeout() {
     return this._requestTimeout;
   }
 
+  /**
+   * Set the global gRPC deadline for all requests.
+   *
+   * @param {number} grpcDeadline - Maximum time in milliseconds for a single gRPC request
+   * @returns {this}
+   */
+  setGrpcDeadline(grpcDeadline) {
+    if (grpcDeadline <= 0) {
+      throw new Error("grpcDeadline must be a positive number");
+    }
+    if (grpcDeadline >= this._requestTimeout) {
+      console.warn(`DEPRECATION WARNING: grpcDeadline (${grpcDeadline}ms) should be smaller than requestTimeout (${this._requestTimeout}ms). ` + `This configuration may cause operations to fail unexpectedly. ` + `This will throw an error in the next major version. Please adjust your timeout values.`);
+    }
+    this._grpcDeadline = grpcDeadline;
+    return this;
+  }
+
+  /**
+   * Get the global gRPC deadline for all requests.
+   *
+   * @returns {number} Maximum time in milliseconds for a single gRPC request
+   */
+  get grpcDeadline() {
+    return this._grpcDeadline;
+  }
+
   /**
    * @returns {number}
    */
@@ -752,7 +805,9 @@ class Client {
    * @returns {(address: string) => ChannelT}
    */
   _createNetworkChannel() {
-    throw new Error("not implemented");
+    return () => {
+      throw new Error("not implemented");
+    };
   }
 
   /**
@@ -760,7 +815,9 @@ class Client {
    * @returns {(address: string) => MirrorChannelT}
    */
   _createMirrorNetworkChannel() {
-    throw new Error("not implemented");
+    return () => {
+      throw new Error("not implemented");
+    };
   }
 
   /**

package/lib/client/Client.d.ts

@@ -22,6 +22,8 @@
  * @property {boolean} [scheduleNetworkUpdate]
  * @property {number} [shard]
  * @property {number} [realm]
+ * @property {number} [grpcDeadline]
+ * @property {number} [requestTimeout]
  */
 /**
  * @typedef {"mainnet" | "testnet" | "previewnet"} NetworkName
@@ -108,6 +110,8 @@ export default class Client<ChannelT extends Channel, MirrorChannelT extends Mir
     private _defaultRegenerateTransactionId;
     /** @private */
     private _requestTimeout;
+    /** @private */
+    private _grpcDeadline;
     /**
      * @type {boolean}
      */
@@ -405,14 +409,31 @@ export default class Client<ChannelT extends Channel, MirrorChannelT extends Mir
      */
     get nodeMaxReadmitPeriod(): number;
     /**
-     * @param {number} requestTimeout - Number of milliseconds
+     * Set the total request timeout for complete operations.
+     *
+     * @param {number} requestTimeout - Maximum time in milliseconds for complete Transaction/Query operations
      * @returns {this}
      */
     setRequestTimeout(requestTimeout: number): this;
     /**
-     * @returns {?number}
+     * Get the total request timeout for complete operations.
+     *
+     * @returns {number} Maximum time in milliseconds for complete Transaction/Query operations
+     */
+    get requestTimeout(): number;
+    /**
+     * Set the global gRPC deadline for all requests.
+     *
+     * @param {number} grpcDeadline - Maximum time in milliseconds for a single gRPC request
+     * @returns {this}
+     */
+    setGrpcDeadline(grpcDeadline: number): this;
+    /**
+     * Get the global gRPC deadline for all requests.
+     *
+     * @returns {number} Maximum time in milliseconds for a single gRPC request
      */
-    get requestTimeout(): number | null;
+    get grpcDeadline(): number;
     /**
      * @returns {number}
      */
@@ -489,6 +510,8 @@ export type ClientConfiguration = {
     scheduleNetworkUpdate?: boolean | undefined;
     shard?: number | undefined;
     realm?: number | undefined;
+    grpcDeadline?: number | undefined;
+    requestTimeout?: number | undefined;
 };
 export type NetworkName = "mainnet" | "testnet" | "previewnet";
 import MirrorNetwork from "./MirrorNetwork.js";

package/lib/client/Client.js

@@ -1,2 +1,2 @@
-import t from"../account/AccountId.js";import e from"../account/AccountBalanceQuery.js";import r from"../Hbar.js";import s from"./Network.js";import n from"./MirrorNetwork.js";import o from"../PublicKey.js";import i from"../PrivateKey.js";import a from"../LedgerId.js";import u from"../file/FileId.js";import"pino";import"../logger/LogLevel.js";import{convertToNumber as h}from"../util.js";import d from"../network/AddressBookQuery.js";class l{constructor(t){this._mirrorNetwork=new n(this._createMirrorNetworkChannel()),this._network=new s(this._createNetworkChannel()),this._operator=null,this._defaultMaxTransactionFee=null,this._defaultMaxQueryPayment=new r(1),null!=t&&null!=t.operator&&this.setOperator(t.operator.accountId,t.operator.privateKey),this._maxAttempts=null,this._signOnDemand=!1,this._autoValidateChecksums=!1,this._minBackoff=250,this._maxBackoff=8e3,this._defaultRegenerateTransactionId=!0,this._requestTimeout=null,this._isUpdatingNetwork=!1,this._networkUpdatePeriod=864e5,this._isShutdown=!1,this._shard=0,this._realm=0,null!=t&&!1!==t.scheduleNetworkUpdate&&this._scheduleNetworkUpdate(),null!=t&&null!=t.shard&&(this._shard=t.shard),null!=t&&null!=t.realm&&(this._realm=t.realm),this._timer,this._logger=null}setNetworkName(t){return console.warn("Deprecated: Use `setLedgerId` instead"),this.setLedgerId(t)}get networkName(){return console.warn("Deprecated: Use `ledgerId` instead"),null!=this.ledgerId?this.ledgerId.toString():null}setLedgerId(t){return this._network.setLedgerId("string"==typeof t?a.fromString(t):t),this}get ledgerId(){return null!=this._network._ledgerId?this._network.ledgerId:null}setNetwork(t){throw new Error("not implemented")}setNetworkFromAddressBook(t){return this._network.setNetworkFromAddressBook(t),this}get network(){return this._network.network}get shard(){return this._shard}get realm(){return this._realm}setMirrorNetwork(t){throw new Error("not implemented")}get mirrorNetwork(){return this._mirrorNetwork.network}get mirrorRestApiBaseUrl(){return this._mirrorNetwork.mirrorRestApiBaseUrl}get signOnDemand(){return this._signOnDemand}setSignOnDemand(t){this._signOnDemand=t}isTransportSecurity(){return this._network.isTransportSecurity()}setTransportSecurity(t){return this._network.setTransportSecurity(t),this}setOperator(t,e){const r="string"==typeof e?i.fromStringDer(e):e;return this.setOperatorWith(t,r.publicKey,t=>Promise.resolve(r.sign(t)))}getOperator(){return this._operator}setOperatorWith(e,r,s){const n=e instanceof t?e:t.fromString(e);return null!=this._network._ledgerId&&n.validateChecksum(this),this._operator={transactionSigner:s,accountId:n,publicKey:r instanceof o?r:o.fromString(r)},this}setAutoValidateChecksums(t){return this._autoValidateChecksums=t,this}isAutoValidateChecksumsEnabled(){return this._autoValidateChecksums}get operatorAccountId(){return null!=this._operator?this._operator.accountId:null}get operatorPublicKey(){return null!=this._operator?this._operator.publicKey:null}get defaultMaxTransactionFee(){return this._defaultMaxTransactionFee}get maxTransactionFee(){return this.defaultMaxTransactionFee}setDefaultMaxTransactionFee(t){if(t.toTinybars().toInt()<0)throw new Error("defaultMaxTransactionFee must be non-negative");return this._defaultMaxTransactionFee=t,this}setMaxTransactionFee(t){return this.setDefaultMaxTransactionFee(t)}get defaultRegenerateTransactionId(){return this._defaultRegenerateTransactionId}setDefaultRegenerateTransactionId(t){return this._defaultRegenerateTransactionId=t,this}get defaultMaxQueryPayment(){return this._defaultMaxQueryPayment}get maxQueryPayment(){return this.defaultMaxQueryPayment}setDefaultMaxQueryPayment(t){if(h(t.toTinybars())<0)throw new Error("defaultMaxQueryPayment must be non-negative");return this._defaultMaxQueryPayment=t,this}setMaxQueryPayment(t){return this.setDefaultMaxQueryPayment(t)}get maxAttempts(){return null!=this._maxAttempts?this._maxAttempts:10}setMaxAttempts(t){return this._maxAttempts=t,this}get maxNodeAttempts(){return this._network.maxNodeAttempts}setMaxNodeAttempts(t){return this._network.setMaxNodeAttempts(t),this}get nodeWaitTime(){return this._network.minBackoff}setNodeWaitTime(t){return this._network.setMinBackoff(t),this}get maxNodesPerTransaction(){return this._network.maxNodesPerTransaction}setMaxNodesPerTransaction(t){return this._network.setMaxNodesPerTransaction(t),this}setMinBackoff(t){if(null==t)throw new Error("minBackoff cannot be null.");if(t>this._maxBackoff)throw new Error("minBackoff cannot be larger than maxBackoff.");return this._minBackoff=t,this}get minBackoff(){return this._minBackoff}setMaxBackoff(t){if(null==t)throw new Error("maxBackoff cannot be null.");if(t<this._minBackoff)throw new Error("maxBackoff cannot be smaller than minBackoff.");return this._maxBackoff=t,this}get maxBackoff(){return this._maxBackoff}setNodeMinBackoff(t){return this._network.setMinBackoff(t),this}get nodeMinBackoff(){return this._network.minBackoff}setNodeMaxBackoff(t){return this._network.setMaxBackoff(t),this}get nodeMaxBackoff(){return this._network.maxBackoff}setNodeMinReadmitPeriod(t){return this._network.setNodeMinReadmitPeriod(t),this}get nodeMinReadmitPeriod(){return this._network.nodeMinReadmitPeriod}setNodeMaxReadmitPeriod(t){return this._network.setNodeMaxReadmitPeriod(t),this}get nodeMaxReadmitPeriod(){return this._network.nodeMaxReadmitPeriod}setRequestTimeout(t){return this._requestTimeout=t,this}get requestTimeout(){return this._requestTimeout}get networkUpdatePeriod(){return this._networkUpdatePeriod}setNetworkUpdatePeriod(t){return clearTimeout(this._timer),this._networkUpdatePeriod=t,this._scheduleNetworkUpdate(),this}setLogger(t){return this._logger=t,this}get logger(){return this._logger}async ping(r){await new e({accountId:r}).setNodeAccountIds([r instanceof t?r:t.fromString(r)]).execute(this)}async pingAll(){for(const t of Object.values(this._network.network))await this.ping(t)}async updateNetwork(){if(this._isUpdatingNetwork)return this;this._isUpdatingNetwork=!0;try{const t=await(new d).setFileId(u.getAddressBookFileIdFor(this._shard,this._realm)).execute(this);this.setNetworkFromAddressBook(t)}catch(t){this._logger&&this._logger.trace(`failed to update client address book: ${t.toString()}`)}finally{this._isUpdatingNetwork=!1}return this}close(){this._network.close(),this._mirrorNetwork.close(),this._isShutdown=!0,clearTimeout(this._timer)}_createNetworkChannel(){throw new Error("not implemented")}_createMirrorNetworkChannel(){throw new Error("not implemented")}_scheduleNetworkUpdate(){this._timer=setTimeout(async()=>{await this.updateNetwork(),this._isShutdown||this._scheduleNetworkUpdate()},this._networkUpdatePeriod)}get isClientShutDown(){return this._isShutdown}static _validateNetworkConsistency(t){if(0===Object.keys(t).length)return;const[,e]=Object.entries(t)[0],r=e.toString(),[s,n]=r.split(".").map(Number),o=Object.values(t).every(t=>{const e=t.toString(),[r,o]=e.split(".").map(Number);return r===s&&o===n});if(!o)throw new Error("Network is not valid, all nodes must be in the same shard and realm")}static _extractShardRealm(t){const e=Object.entries(t);if(0===e.length)return{shard:0,realm:0};const[,r]=e[0],s=r.toString(),[n,o]=s.split(".").map(Number);return{shard:n,realm:o}}}export{l as default};
+import e from"../account/AccountId.js";import t from"../account/AccountBalanceQuery.js";import r from"../Hbar.js";import s from"./Network.js";import i from"./MirrorNetwork.js";import n from"../PublicKey.js";import o from"../PrivateKey.js";import a from"../LedgerId.js";import u from"../file/FileId.js";import"pino";import"../logger/LogLevel.js";import{convertToNumber as h}from"../util.js";import l from"../network/AddressBookQuery.js";import{DEFAULT_REQUEST_TIMEOUT as d,DEFAULT_GRPC_DEADLINE as m}from"../constants/ClientConstants.js";class c{constructor(e){this._mirrorNetwork=new i(this._createMirrorNetworkChannel()),this._network=new s(this._createNetworkChannel()),this._operator=null,this._defaultMaxTransactionFee=null,this._defaultMaxQueryPayment=new r(1),null!=e&&null!=e.operator&&this.setOperator(e.operator.accountId,e.operator.privateKey),this._maxAttempts=null,this._signOnDemand=!1,this._autoValidateChecksums=!1,this._minBackoff=250,this._maxBackoff=8e3,this._defaultRegenerateTransactionId=!0,this._requestTimeout=d,this._grpcDeadline=m,this._isUpdatingNetwork=!1,this._networkUpdatePeriod=864e5,this._isShutdown=!1,this._shard=0,this._realm=0,null!=e&&!1!==e.scheduleNetworkUpdate&&this._scheduleNetworkUpdate(),null!=e&&null!=e.shard&&(this._shard=e.shard),null!=e&&null!=e.realm&&(this._realm=e.realm),null!=e&&null!=e.grpcDeadline&&this.setGrpcDeadline(e.grpcDeadline),null!=e&&null!=e.requestTimeout&&this.setRequestTimeout(e.requestTimeout),this._requestTimeout<=this._grpcDeadline&&console.warn(`DEPRECATION WARNING: requestTimeout (${this._requestTimeout}ms) should be larger than grpcDeadline (${this._grpcDeadline}ms). This configuration may cause operations to fail unexpectedly. This will throw an error in the next major version. Please adjust your timeout values.`),this._timer,this._logger=null}setNetworkName(e){return console.warn("Deprecated: Use `setLedgerId` instead"),this.setLedgerId(e)}get networkName(){return console.warn("Deprecated: Use `ledgerId` instead"),null!=this.ledgerId?this.ledgerId.toString():null}setLedgerId(e){return this._network.setLedgerId("string"==typeof e?a.fromString(e):e),this}get ledgerId(){return null!=this._network._ledgerId?this._network.ledgerId:null}setNetwork(e){throw new Error("not implemented")}setNetworkFromAddressBook(e){return this._network.setNetworkFromAddressBook(e),this}get network(){return this._network.network}get shard(){return this._shard}get realm(){return this._realm}setMirrorNetwork(e){throw new Error("not implemented")}get mirrorNetwork(){return this._mirrorNetwork.network}get mirrorRestApiBaseUrl(){return this._mirrorNetwork.mirrorRestApiBaseUrl}get signOnDemand(){return this._signOnDemand}setSignOnDemand(e){this._signOnDemand=e}isTransportSecurity(){return this._network.isTransportSecurity()}setTransportSecurity(e){return this._network.setTransportSecurity(e),this}setOperator(e,t){const r="string"==typeof t?o.fromStringDer(t):t;return this.setOperatorWith(e,r.publicKey,e=>Promise.resolve(r.sign(e)))}getOperator(){return this._operator}setOperatorWith(t,r,s){const i=t instanceof e?t:e.fromString(t);return null!=this._network._ledgerId&&i.validateChecksum(this),this._operator={transactionSigner:s,accountId:i,publicKey:r instanceof n?r:n.fromString(r)},this}setAutoValidateChecksums(e){return this._autoValidateChecksums=e,this}isAutoValidateChecksumsEnabled(){return this._autoValidateChecksums}get operatorAccountId(){return null!=this._operator?this._operator.accountId:null}get operatorPublicKey(){return null!=this._operator?this._operator.publicKey:null}get defaultMaxTransactionFee(){return this._defaultMaxTransactionFee}get maxTransactionFee(){return this.defaultMaxTransactionFee}setDefaultMaxTransactionFee(e){if(e.toTinybars().toInt()<0)throw new Error("defaultMaxTransactionFee must be non-negative");return this._defaultMaxTransactionFee=e,this}setMaxTransactionFee(e){return this.setDefaultMaxTransactionFee(e)}get defaultRegenerateTransactionId(){return this._defaultRegenerateTransactionId}setDefaultRegenerateTransactionId(e){return this._defaultRegenerateTransactionId=e,this}get defaultMaxQueryPayment(){return this._defaultMaxQueryPayment}get maxQueryPayment(){return this.defaultMaxQueryPayment}setDefaultMaxQueryPayment(e){if(h(e.toTinybars())<0)throw new Error("defaultMaxQueryPayment must be non-negative");return this._defaultMaxQueryPayment=e,this}setMaxQueryPayment(e){return this.setDefaultMaxQueryPayment(e)}get maxAttempts(){return null!=this._maxAttempts?this._maxAttempts:10}setMaxAttempts(e){return this._maxAttempts=e,this}get maxNodeAttempts(){return this._network.maxNodeAttempts}setMaxNodeAttempts(e){return this._network.setMaxNodeAttempts(e),this}get nodeWaitTime(){return this._network.minBackoff}setNodeWaitTime(e){return this._network.setMinBackoff(e),this}get maxNodesPerTransaction(){return this._network.maxNodesPerTransaction}setMaxNodesPerTransaction(e){return this._network.setMaxNodesPerTransaction(e),this}setMinBackoff(e){if(null==e)throw new Error("minBackoff cannot be null.");if(e>this._maxBackoff)throw new Error("minBackoff cannot be larger than maxBackoff.");return this._minBackoff=e,this}get minBackoff(){return this._minBackoff}setMaxBackoff(e){if(null==e)throw new Error("maxBackoff cannot be null.");if(e<this._minBackoff)throw new Error("maxBackoff cannot be smaller than minBackoff.");return this._maxBackoff=e,this}get maxBackoff(){return this._maxBackoff}setNodeMinBackoff(e){return this._network.setMinBackoff(e),this}get nodeMinBackoff(){return this._network.minBackoff}setNodeMaxBackoff(e){return this._network.setMaxBackoff(e),this}get nodeMaxBackoff(){return this._network.maxBackoff}setNodeMinReadmitPeriod(e){return this._network.setNodeMinReadmitPeriod(e),this}get nodeMinReadmitPeriod(){return this._network.nodeMinReadmitPeriod}setNodeMaxReadmitPeriod(e){return this._network.setNodeMaxReadmitPeriod(e),this}get nodeMaxReadmitPeriod(){return this._network.nodeMaxReadmitPeriod}setRequestTimeout(e){if(e<=0)throw new Error("requestTimeout must be a positive number");return e<=this._grpcDeadline&&console.warn(`DEPRECATION WARNING: requestTimeout (${e}ms) should be larger than grpcDeadline (${this._grpcDeadline}ms). This configuration may cause operations to fail unexpectedly. This will throw an error in the next major version. Please adjust your timeout values.`),this._requestTimeout=e,this}get requestTimeout(){return this._requestTimeout}setGrpcDeadline(e){if(e<=0)throw new Error("grpcDeadline must be a positive number");return e>=this._requestTimeout&&console.warn(`DEPRECATION WARNING: grpcDeadline (${e}ms) should be smaller than requestTimeout (${this._requestTimeout}ms). This configuration may cause operations to fail unexpectedly. This will throw an error in the next major version. Please adjust your timeout values.`),this._grpcDeadline=e,this}get grpcDeadline(){return this._grpcDeadline}get networkUpdatePeriod(){return this._networkUpdatePeriod}setNetworkUpdatePeriod(e){return clearTimeout(this._timer),this._networkUpdatePeriod=e,this._scheduleNetworkUpdate(),this}setLogger(e){return this._logger=e,this}get logger(){return this._logger}async ping(r){await new t({accountId:r}).setNodeAccountIds([r instanceof e?r:e.fromString(r)]).execute(this)}async pingAll(){for(const e of Object.values(this._network.network))await this.ping(e)}async updateNetwork(){if(this._isUpdatingNetwork)return this;this._isUpdatingNetwork=!0;try{const e=await(new l).setFileId(u.getAddressBookFileIdFor(this._shard,this._realm)).execute(this);this.setNetworkFromAddressBook(e)}catch(e){this._logger&&this._logger.trace(`failed to update client address book: ${e.toString()}`)}finally{this._isUpdatingNetwork=!1}return this}close(){this._network.close(),this._mirrorNetwork.close(),this._isShutdown=!0,clearTimeout(this._timer)}_createNetworkChannel(){return()=>{throw new Error("not implemented")}}_createMirrorNetworkChannel(){return()=>{throw new Error("not implemented")}}_scheduleNetworkUpdate(){this._timer=setTimeout(async()=>{await this.updateNetwork(),this._isShutdown||this._scheduleNetworkUpdate()},this._networkUpdatePeriod)}get isClientShutDown(){return this._isShutdown}static _validateNetworkConsistency(e){if(0===Object.keys(e).length)return;const[,t]=Object.entries(e)[0],r=t.toString(),[s,i]=r.split(".").map(Number),n=Object.values(e).every(e=>{const t=e.toString(),[r,n]=t.split(".").map(Number);return r===s&&n===i});if(!n)throw new Error("Network is not valid, all nodes must be in the same shard and realm")}static _extractShardRealm(e){const t=Object.entries(e);if(0===t.length)return{shard:0,realm:0};const[,r]=t[0],s=r.toString(),[i,n]=s.split(".").map(Number);return{shard:i,realm:n}}}export{c as default};
 //# sourceMappingURL=Client.js.map