@hiero-ledger/sdk 2.70.0

package/lib/LocalProvider.cjs

@@ -0,0 +1,159 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _NodeClient = _interopRequireDefault(require("./client/NodeClient.cjs"));
+var _AccountBalanceQuery = _interopRequireDefault(require("./account/AccountBalanceQuery.cjs"));
+var _AccountInfoQuery = _interopRequireDefault(require("./account/AccountInfoQuery.cjs"));
+var _AccountRecordsQuery = _interopRequireDefault(require("./account/AccountRecordsQuery.cjs"));
+var _TransactionReceiptQuery = _interopRequireDefault(require("./transaction/TransactionReceiptQuery.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @typedef {import("./Provider.js").Provider} Provider
+ * @typedef {import("./LedgerId.js").default} LedgerId
+ * @typedef {import("./Key.js").default} Key
+ * @typedef {import("./transaction/Transaction.js").default} Transaction
+ * @typedef {import("./transaction/TransactionId.js").default} TransactionId
+ * @typedef {import("./transaction/TransactionResponse.js").default} TransactionResponse
+ * @typedef {import("./transaction/TransactionReceipt.js").default} TransactionReceipt
+ * @typedef {import("./transaction/TransactionRecord.js").default} TransactionRecord
+ * @typedef {import("./account/AccountId.js").default} AccountId
+ * @typedef {import("./account/AccountBalance.js").default} AccountBalance
+ * @typedef {import("./account/AccountInfo.js").default} AccountInfo
+ * @typedef {import("./logger/Logger.js").default} Logger
+ */
+
+/**
+ * @template {any} O
+ * @typedef {import("./query/Query.js").default<O>} Query<O>
+ */
+
+/**
+ * @template RequestT
+ * @template ResponseT
+ * @template OutputT
+ * @typedef {import("./Executable.js").default<RequestT, ResponseT, OutputT>} Executable<RequestT, ResponseT, OutputT>
+ */
+
+/**
+ * @implements {Provider}
+ */
+class LocalProvider {
+  /**
+   * @param {object} props
+   * @param {Client} [props.client]
+   */
+  constructor(props = {}) {
+    if (props != null && props.client != null) {
+      this._client = props.client;
+      return;
+    }
+    if (process.env.HEDERA_NETWORK == null) {
+      throw new Error("LocalProvider requires the `HEDERA_NETWORK` environment variable to be set");
+    }
+    this._client = _NodeClient.default.forName(process.env.HEDERA_NETWORK);
+  }
+
+  /**
+   * @param {Client} client
+   * @returns {LocalProvider}
+   */
+  static fromClient(client) {
+    return new LocalProvider({
+      client
+    });
+  }
+
+  /**
+   * @returns {LedgerId?}
+   */
+  getLedgerId() {
+    return this._client.ledgerId;
+  }
+
+  /**
+   * @returns {{[key: string]: (string | AccountId)}}
+   */
+  getNetwork() {
+    return this._client.network;
+  }
+
+  /**
+   * @returns {string[]}
+   */
+  getMirrorNetwork() {
+    return this._client.mirrorNetwork;
+  }
+
+  /**
+   * @param {AccountId | string} accountId
+   * @returns {Promise<AccountBalance>}
+   */
+  getAccountBalance(accountId) {
+    return new _AccountBalanceQuery.default().setAccountId(accountId).execute(this._client);
+  }
+
+  /**
+   * @param {AccountId | string} accountId
+   * @returns {Promise<AccountInfo>}
+   */
+  getAccountInfo(accountId) {
+    return new _AccountInfoQuery.default().setAccountId(accountId).execute(this._client);
+  }
+
+  /**
+   * @param {AccountId | string} accountId
+   * @returns {Promise<TransactionRecord[]>}
+   */
+  getAccountRecords(accountId) {
+    return new _AccountRecordsQuery.default().setAccountId(accountId).execute(this._client);
+  }
+
+  /**
+   * @param {TransactionId | string} transactionId
+   * @returns {Promise<TransactionReceipt>}
+   */
+  getTransactionReceipt(transactionId) {
+    return new _TransactionReceiptQuery.default().setTransactionId(transactionId).execute(this._client);
+  }
+
+  /**
+   * @param {TransactionResponse} response
+   * @returns {Promise<TransactionReceipt>}
+   */
+  waitForReceipt(response) {
+    return new _TransactionReceiptQuery.default().setNodeAccountIds([response.nodeId]).setTransactionId(response.transactionId).execute(this._client);
+  }
+
+  /**
+   * @template RequestT
+   * @template ResponseT
+   * @template OutputT
+   * @param {Executable<RequestT, ResponseT, OutputT>} request
+   * @returns {Promise<OutputT>}
+   */
+  call(request) {
+    return request.execute(this._client);
+  }
+
+  /**
+   * @returns {void}
+   */
+  close() {
+    this._client.close();
+  }
+
+  /**
+   * Set logger
+   *
+   * @param {Logger} logger
+   */
+  setLogger(logger) {
+    this._client.setLogger(logger);
+  }
+}
+exports.default = LocalProvider;

package/lib/LocalProvider.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @typedef {import("./Provider.js").Provider} Provider
+ * @typedef {import("./LedgerId.js").default} LedgerId
+ * @typedef {import("./Key.js").default} Key
+ * @typedef {import("./transaction/Transaction.js").default} Transaction
+ * @typedef {import("./transaction/TransactionId.js").default} TransactionId
+ * @typedef {import("./transaction/TransactionResponse.js").default} TransactionResponse
+ * @typedef {import("./transaction/TransactionReceipt.js").default} TransactionReceipt
+ * @typedef {import("./transaction/TransactionRecord.js").default} TransactionRecord
+ * @typedef {import("./account/AccountId.js").default} AccountId
+ * @typedef {import("./account/AccountBalance.js").default} AccountBalance
+ * @typedef {import("./account/AccountInfo.js").default} AccountInfo
+ * @typedef {import("./logger/Logger.js").default} Logger
+ */
+/**
+ * @template {any} O
+ * @typedef {import("./query/Query.js").default<O>} Query<O>
+ */
+/**
+ * @template RequestT
+ * @template ResponseT
+ * @template OutputT
+ * @typedef {import("./Executable.js").default<RequestT, ResponseT, OutputT>} Executable<RequestT, ResponseT, OutputT>
+ */
+/**
+ * @implements {Provider}
+ */
+export default class LocalProvider implements Provider {
+    /**
+     * @param {Client} client
+     * @returns {LocalProvider}
+     */
+    static fromClient(client: Client): LocalProvider;
+    /**
+     * @param {object} props
+     * @param {Client} [props.client]
+     */
+    constructor(props?: {
+        client?: Client | undefined;
+    });
+    _client: Client;
+    /**
+     * @returns {LedgerId?}
+     */
+    getLedgerId(): LedgerId | null;
+    /**
+     * @returns {{[key: string]: (string | AccountId)}}
+     */
+    getNetwork(): {
+        [key: string]: (string | AccountId);
+    };
+    /**
+     * @returns {string[]}
+     */
+    getMirrorNetwork(): string[];
+    /**
+     * @param {AccountId | string} accountId
+     * @returns {Promise<AccountBalance>}
+     */
+    getAccountBalance(accountId: AccountId | string): Promise<AccountBalance>;
+    /**
+     * @param {AccountId | string} accountId
+     * @returns {Promise<AccountInfo>}
+     */
+    getAccountInfo(accountId: AccountId | string): Promise<AccountInfo>;
+    /**
+     * @param {AccountId | string} accountId
+     * @returns {Promise<TransactionRecord[]>}
+     */
+    getAccountRecords(accountId: AccountId | string): Promise<TransactionRecord[]>;
+    /**
+     * @param {TransactionId | string} transactionId
+     * @returns {Promise<TransactionReceipt>}
+     */
+    getTransactionReceipt(transactionId: TransactionId | string): Promise<TransactionReceipt>;
+    /**
+     * @param {TransactionResponse} response
+     * @returns {Promise<TransactionReceipt>}
+     */
+    waitForReceipt(response: TransactionResponse): Promise<TransactionReceipt>;
+    /**
+     * @template RequestT
+     * @template ResponseT
+     * @template OutputT
+     * @param {Executable<RequestT, ResponseT, OutputT>} request
+     * @returns {Promise<OutputT>}
+     */
+    call<RequestT, ResponseT, OutputT>(request: Executable<RequestT, ResponseT, OutputT>): Promise<OutputT>;
+    /**
+     * @returns {void}
+     */
+    close(): void;
+    /**
+     * Set logger
+     *
+     * @param {Logger} logger
+     */
+    setLogger(logger: Logger): void;
+}
+export type Provider = import("./Provider.js").Provider;
+export type LedgerId = import("./LedgerId.js").default;
+export type Key = import("./Key.js").default;
+export type Transaction = import("./transaction/Transaction.js").default;
+export type TransactionId = import("./transaction/TransactionId.js").default;
+export type TransactionResponse = import("./transaction/TransactionResponse.js").default;
+export type TransactionReceipt = import("./transaction/TransactionReceipt.js").default;
+export type TransactionRecord = import("./transaction/TransactionRecord.js").default;
+export type AccountId = import("./account/AccountId.js").default;
+export type AccountBalance = import("./account/AccountBalance.js").default;
+export type AccountInfo = import("./account/AccountInfo.js").default;
+export type Logger = import("./logger/Logger.js").default;
+/**
+ * <O>
+ */
+export type Query<O extends unknown> = import("./query/Query.js").default<O>;
+/**
+ * <RequestT, ResponseT, OutputT>
+ */
+export type Executable<RequestT, ResponseT, OutputT> = import("./Executable.js").default<RequestT, ResponseT, OutputT>;
+import Client from "./client/NodeClient.js";

package/lib/LocalProvider.js

@@ -0,0 +1,2 @@
+import e from"./client/NodeClient.js";import t from"./account/AccountBalanceQuery.js";import n from"./account/AccountInfoQuery.js";import r from"./account/AccountRecordsQuery.js";import c from"./transaction/TransactionReceiptQuery.js";class o{constructor(t={}){if(null==t||null==t.client){if(null==process.env.HEDERA_NETWORK)throw new Error("LocalProvider requires the `HEDERA_NETWORK` environment variable to be set");this._client=e.forName(process.env.HEDERA_NETWORK)}else this._client=t.client}static fromClient(e){return new o({client:e})}getLedgerId(){return this._client.ledgerId}getNetwork(){return this._client.network}getMirrorNetwork(){return this._client.mirrorNetwork}getAccountBalance(e){return(new t).setAccountId(e).execute(this._client)}getAccountInfo(e){return(new n).setAccountId(e).execute(this._client)}getAccountRecords(e){return(new r).setAccountId(e).execute(this._client)}getTransactionReceipt(e){return(new c).setTransactionId(e).execute(this._client)}waitForReceipt(e){return(new c).setNodeAccountIds([e.nodeId]).setTransactionId(e.transactionId).execute(this._client)}call(e){return e.execute(this._client)}close(){this._client.close()}setLogger(e){this._client.setLogger(e)}}export{o as default};
+//# sourceMappingURL=LocalProvider.js.map

package/lib/LocalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalProvider.js","sources":["../src/LocalProvider.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Client from \"./client/NodeClient.js\";\nimport AccountBalanceQuery from \"./account/AccountBalanceQuery.js\";\nimport AccountInfoQuery from \"./account/AccountInfoQuery.js\";\nimport AccountRecordsQuery from \"./account/AccountRecordsQuery.js\";\nimport TransactionReceiptQuery from \"./transaction/TransactionReceiptQuery.js\";\n\n/**\n * @typedef {import(\"./Provider.js\").Provider} Provider\n * @typedef {import(\"./LedgerId.js\").default} LedgerId\n * @typedef {import(\"./Key.js\").default} Key\n * @typedef {import(\"./transaction/Transaction.js\").default} Transaction\n * @typedef {import(\"./transaction/TransactionId.js\").default} TransactionId\n * @typedef {import(\"./transaction/TransactionResponse.js\").default} TransactionResponse\n * @typedef {import(\"./transaction/TransactionReceipt.js\").default} TransactionReceipt\n * @typedef {import(\"./transaction/TransactionRecord.js\").default} TransactionRecord\n * @typedef {import(\"./account/AccountId.js\").default} AccountId\n * @typedef {import(\"./account/AccountBalance.js\").default} AccountBalance\n * @typedef {import(\"./account/AccountInfo.js\").default} AccountInfo\n * @typedef {import(\"./logger/Logger.js\").default} Logger\n */\n\n/**\n * @template {any} O\n * @typedef {import(\"./query/Query.js\").default<O>} Query<O>\n */\n\n/**\n * @template RequestT\n * @template ResponseT\n * @template OutputT\n * @typedef {import(\"./Executable.js\").default<RequestT, ResponseT, OutputT>} Executable<RequestT, ResponseT, OutputT>\n */\n\n/**\n * @implements {Provider}\n */\nexport default class LocalProvider {\n    /**\n     * @param {object} props\n     * @param {Client} [props.client]\n     */\n    constructor(props = {}) {\n        if (props != null && props.client != null) {\n            this._client = props.client;\n            return;\n        }\n\n        if (process.env.HEDERA_NETWORK == null) {\n            throw new Error(\n                \"LocalProvider requires the `HEDERA_NETWORK` environment variable to be set\",\n            );\n        }\n\n        this._client = Client.forName(process.env.HEDERA_NETWORK);\n    }\n\n    /**\n     * @param {Client} client\n     * @returns {LocalProvider}\n     */\n    static fromClient(client) {\n        return new LocalProvider({ client });\n    }\n\n    /**\n     * @returns {LedgerId?}\n     */\n    getLedgerId() {\n        return this._client.ledgerId;\n    }\n\n    /**\n     * @returns {{[key: string]: (string | AccountId)}}\n     */\n    getNetwork() {\n        return this._client.network;\n    }\n\n    /**\n     * @returns {string[]}\n     */\n    getMirrorNetwork() {\n        return this._client.mirrorNetwork;\n    }\n\n    /**\n     * @param {AccountId | string} accountId\n     * @returns {Promise<AccountBalance>}\n     */\n    getAccountBalance(accountId) {\n        return new AccountBalanceQuery()\n            .setAccountId(accountId)\n            .execute(this._client);\n    }\n\n    /**\n     * @param {AccountId | string} accountId\n     * @returns {Promise<AccountInfo>}\n     */\n    getAccountInfo(accountId) {\n        return new AccountInfoQuery()\n            .setAccountId(accountId)\n            .execute(this._client);\n    }\n\n    /**\n     * @param {AccountId | string} accountId\n     * @returns {Promise<TransactionRecord[]>}\n     */\n    getAccountRecords(accountId) {\n        return new AccountRecordsQuery()\n            .setAccountId(accountId)\n            .execute(this._client);\n    }\n\n    /**\n     * @param {TransactionId | string} transactionId\n     * @returns {Promise<TransactionReceipt>}\n     */\n    getTransactionReceipt(transactionId) {\n        return new TransactionReceiptQuery()\n            .setTransactionId(transactionId)\n            .execute(this._client);\n    }\n\n    /**\n     * @param {TransactionResponse} response\n     * @returns {Promise<TransactionReceipt>}\n     */\n    waitForReceipt(response) {\n        return new TransactionReceiptQuery()\n            .setNodeAccountIds([response.nodeId])\n            .setTransactionId(response.transactionId)\n            .execute(this._client);\n    }\n\n    /**\n     * @template RequestT\n     * @template ResponseT\n     * @template OutputT\n     * @param {Executable<RequestT, ResponseT, OutputT>} request\n     * @returns {Promise<OutputT>}\n     */\n    call(request) {\n        return request.execute(this._client);\n    }\n\n    /**\n     * @returns {void}\n     */\n    close() {\n        this._client.close();\n    }\n\n    /**\n     * Set logger\n     *\n     * @param {Logger} logger\n     */\n    setLogger(logger) {\n        this._client.setLogger(logger);\n    }\n}\n"],"names":["LocalProvider","constructor","props","client","process","env","HEDERA_NETWORK","Error","this","_client","Client","forName","fromClient","getLedgerId","ledgerId","getNetwork","network","getMirrorNetwork","mirrorNetwork","getAccountBalance","accountId","AccountBalanceQuery","setAccountId","execute","getAccountInfo","AccountInfoQuery","getAccountRecords","AccountRecordsQuery","getTransactionReceipt","transactionId","TransactionReceiptQuery","setTransactionId","waitForReceipt","response","setNodeAccountIds","nodeId","call","request","close","setLogger","logger"],"mappings":"2OAsCe,MAAMA,EAKjB,WAAAC,CAAYC,EAAQ,IAChB,GAAa,MAATA,GAAiC,MAAhBA,EAAMC,OAA3B,CAKA,GAAkC,MAA9BC,QAAQC,IAAIC,eACZ,MAAM,IAAIC,MACN,8EAIRC,KAAKC,QAAUC,EAAOC,QAAQP,QAAQC,IAAIC,eARlD,MAFYE,KAAKC,QAAUP,EAAMC,MAWjC,CAMI,iBAAOS,CAAWT,GACd,OAAO,IAAIH,EAAc,CAAEG,UACnC,CAKI,WAAAU,GACI,OAAOL,KAAKC,QAAQK,QAC5B,CAKI,UAAAC,GACI,OAAOP,KAAKC,QAAQO,OAC5B,CAKI,gBAAAC,GACI,OAAOT,KAAKC,QAAQS,aAC5B,CAMI,iBAAAC,CAAkBC,GACd,OAAO,IAAIC,GACNC,aAAaF,GACbG,QAAQf,KAAKC,QAC1B,CAMI,cAAAe,CAAeJ,GACX,OAAO,IAAIK,GACNH,aAAaF,GACbG,QAAQf,KAAKC,QAC1B,CAMI,iBAAAiB,CAAkBN,GACd,OAAO,IAAIO,GACNL,aAAaF,GACbG,QAAQf,KAAKC,QAC1B,CAMI,qBAAAmB,CAAsBC,GAClB,OAAO,IAAIC,GACNC,iBAAiBF,GACjBN,QAAQf,KAAKC,QAC1B,CAMI,cAAAuB,CAAeC,GACX,OAAO,IAAIH,GACNI,kBAAkB,CAACD,EAASE,SAC5BJ,iBAAiBE,EAASJ,eAC1BN,QAAQf,KAAKC,QAC1B,CASI,IAAA2B,CAAKC,GACD,OAAOA,EAAQd,QAAQf,KAAKC,QACpC,CAKI,KAAA6B,GACI9B,KAAKC,QAAQ6B,OACrB,CAOI,SAAAC,CAAUC,GACNhC,KAAKC,QAAQ8B,UAAUC,EAC/B"}

package/lib/ManagedNode.cjs

@@ -0,0 +1,245 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _ManagedNodeAddress = _interopRequireDefault(require("./ManagedNodeAddress.cjs"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @typedef {import("./account/AccountId.js").default} AccountId
+ * @typedef {import("./channel/Channel.js").default} Channel
+ * @typedef {import("./channel/MirrorChannel.js").default} MirrorChannel
+ * @typedef {import("./address_book/NodeAddress.js").default} NodeAddress
+ */
+
+/**
+ * @template {Channel | MirrorChannel} ChannelT
+ * @typedef {object} NewNode
+ * @property {string | ManagedNodeAddress} address
+ * @property {(address: string, cert?: string) => ChannelT} channelInitFunction
+ */
+
+/**
+ * @template {Channel | MirrorChannel} ChannelT
+ * @typedef {object} CloneNode
+ * @property {ManagedNode<ChannelT>} node
+ * @property {ManagedNodeAddress} address
+ */
+
+/**
+ * @abstract
+ * @template {Channel | MirrorChannel} ChannelT
+ */
+class ManagedNode {
+  /**
+   * @param {object} props
+   * @param {NewNode<ChannelT>=} [props.newNode]
+   * @param {CloneNode<ChannelT>=} [props.cloneNode]
+   */
+  constructor(props = {}) {
+    if (props.newNode != null) {
+      this._address = typeof props.newNode.address === "string" ? _ManagedNodeAddress.default.fromString(props.newNode.address) : props.newNode.address;
+
+      /** @type {string=} */
+      this._cert = undefined;
+
+      /** @type {ChannelT | null} */
+      this._channel = null;
+
+      /** @type {(address: string, cert?: string) => ChannelT} */
+      this._channelInitFunction = props.newNode.channelInitFunction;
+      this._lastUsed = Date.now();
+      this._readmitTime = Date.now();
+      this._useCount = 0;
+      this._badGrpcStatusCount = 0;
+      this._minBackoff = 8000;
+      this._maxBackoff = 1000 * 60 * 60;
+      this._currentBackoff = this._minBackoff;
+    } else if (props.cloneNode != null) {
+      /** @type {ManagedNodeAddress} */
+      this._address = props.cloneNode.address;
+
+      /** @type {string=} */
+      this._cert = props.cloneNode.node._cert;
+
+      /** @type {ChannelT | null} */
+      this._channel = props.cloneNode.node._channel;
+
+      /** @type {(address: string, cert?: string) => ChannelT} */
+      this._channelInitFunction = props.cloneNode.node._channelInitFunction;
+
+      /** @type {number} */
+      this._currentBackoff = props.cloneNode.node._currentBackoff;
+
+      /** @type {number} */
+      this._lastUsed = props.cloneNode.node._lastUsed;
+
+      /** @type {number} */
+      this._readmitTime = props.cloneNode.node._readmitTime;
+
+      /** @type {number} */
+      this._useCount = props.cloneNode.node._useCount;
+
+      /** @type {number} */
+      this._badGrpcStatusCount = props.cloneNode.node._badGrpcStatusCount;
+
+      /** @type {number} */
+      this._minBackoff = props.cloneNode.node._minBackoff;
+
+      /** @type {number} */
+      this._maxBackoff = props.cloneNode.node._minBackoff;
+    } else {
+      throw new Error(`failed to create ManagedNode: ${JSON.stringify(props)}`);
+    }
+  }
+
+  /**
+   * @abstract
+   * @returns {string}
+   */
+  // eslint-disable-next-line jsdoc/require-returns-check
+  getKey() {
+    throw new Error("not implemented");
+  }
+
+  /**
+   * @param {string} ledgerId
+   * @returns {this}
+   */
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  setCert(ledgerId) {
+    return this;
+  }
+
+  /**
+   * @returns {ManagedNodeAddress}
+   */
+  get address() {
+    return this._address;
+  }
+
+  /**
+   * @returns {number}
+   */
+  get attempts() {
+    return this._badGrpcStatusCount;
+  }
+
+  /**
+   * @returns {number}
+   */
+  get minBackoff() {
+    return this._minBackoff;
+  }
+
+  /**
+   * @param {number} minBackoff
+   * @returns {this}
+   */
+  setMinBackoff(minBackoff) {
+    if (this._currentBackoff <= minBackoff) {
+      this._currentBackoff = minBackoff;
+    }
+    this._minBackoff = minBackoff;
+    return this;
+  }
+
+  /**
+   * @returns {number}
+   */
+  get maxBackoff() {
+    return this._maxBackoff;
+  }
+
+  /**
+   * @param {number} maxBackoff
+   * @returns {this}
+   */
+  setMaxBackoff(maxBackoff) {
+    if (this._currentBackoff <= maxBackoff) {
+      this._currentBackoff = maxBackoff;
+    }
+    this._maxBackoff = maxBackoff;
+    return this;
+  }
+  getChannel() {
+    this._useCount++;
+    this.__lastUsed = Date.now();
+    if (this._channel != null) {
+      return this._channel;
+    }
+    this._channel = this._channelInitFunction(this.address.toString(), this._cert);
+    return this._channel;
+  }
+
+  /**
+   * Determines if this node is healthy by checking if this node hasn't been
+   * in use for a the required `_currentBackoff` period. Since this looks at `this._lastUsed`
+   * and that value is only set in the `wait()` method, any node that has not
+   * returned a bad gRPC status will always be considered healthy.
+   *
+   * @returns {boolean}
+   */
+  isHealthy() {
+    return this._readmitTime <= Date.now();
+  }
+  increaseBackoff() {
+    this._currentBackoff = Math.min(this._currentBackoff * 2, this._maxBackoff);
+    this._readmitTime = Date.now() + this._currentBackoff;
+  }
+  decreaseBackoff() {
+    this._currentBackoff = Math.max(this._currentBackoff / 2, this._minBackoff);
+  }
+
+  /**
+   * @returns {number}
+   */
+  getRemainingTime() {
+    return this._readmitTime - this._lastUsed;
+  }
+
+  /**
+   * This is only ever called if the node itself is down.
+   * A node returning a transaction with a bad status code does not indicate
+   * the node is down, and hence this method will not be called.
+   *
+   * @returns {Promise<void>}
+   */
+  backoff() {
+    return new Promise(resolve => setTimeout(resolve, this.getRemainingTime()));
+  }
+
+  /**
+   * @param {ManagedNode<*>} node
+   * @returns {number}
+   */
+  compare(node) {
+    let comparison = this.getRemainingTime() - node.getRemainingTime();
+    if (comparison != 0) {
+      return comparison;
+    }
+    comparison = this._currentBackoff - node._currentBackoff;
+    if (comparison != 0) {
+      return comparison;
+    }
+    comparison = this._badGrpcStatusCount - node._badGrpcStatusCount;
+    if (comparison != 0) {
+      return comparison;
+    }
+    comparison = this._useCount - node._useCount;
+    if (comparison != 0) {
+      return comparison;
+    }
+    return this._lastUsed - node._lastUsed;
+  }
+  close() {
+    if (this._channel != null) {
+      this._channel.close();
+    }
+    this._channel = null;
+  }
+}
+exports.default = ManagedNode;

package/lib/ManagedNode.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @typedef {import("./account/AccountId.js").default} AccountId
+ * @typedef {import("./channel/Channel.js").default} Channel
+ * @typedef {import("./channel/MirrorChannel.js").default} MirrorChannel
+ * @typedef {import("./address_book/NodeAddress.js").default} NodeAddress
+ */
+/**
+ * @template {Channel | MirrorChannel} ChannelT
+ * @typedef {object} NewNode
+ * @property {string | ManagedNodeAddress} address
+ * @property {(address: string, cert?: string) => ChannelT} channelInitFunction
+ */
+/**
+ * @template {Channel | MirrorChannel} ChannelT
+ * @typedef {object} CloneNode
+ * @property {ManagedNode<ChannelT>} node
+ * @property {ManagedNodeAddress} address
+ */
+/**
+ * @abstract
+ * @template {Channel | MirrorChannel} ChannelT
+ */
+export default class ManagedNode<ChannelT extends Channel | MirrorChannel> {
+    /**
+     * @param {object} props
+     * @param {NewNode<ChannelT>=} [props.newNode]
+     * @param {CloneNode<ChannelT>=} [props.cloneNode]
+     */
+    constructor(props?: {
+        newNode?: NewNode<ChannelT> | undefined;
+        cloneNode?: CloneNode<ChannelT> | undefined;
+    });
+    _address: ManagedNodeAddress;
+    /** @type {string=} */
+    _cert: string | undefined;
+    /** @type {ChannelT | null} */
+    _channel: ChannelT | null;
+    /** @type {(address: string, cert?: string) => ChannelT} */
+    _channelInitFunction: (address: string, cert?: string) => ChannelT;
+    _lastUsed: number;
+    _readmitTime: number;
+    _useCount: number;
+    _badGrpcStatusCount: number;
+    _minBackoff: number;
+    _maxBackoff: number;
+    _currentBackoff: number;
+    /**
+     * @abstract
+     * @returns {string}
+     */
+    getKey(): string;
+    /**
+     * @param {string} ledgerId
+     * @returns {this}
+     */
+    setCert(ledgerId: string): this;
+    /**
+     * @returns {ManagedNodeAddress}
+     */
+    get address(): ManagedNodeAddress;
+    /**
+     * @returns {number}
+     */
+    get attempts(): number;
+    /**
+     * @returns {number}
+     */
+    get minBackoff(): number;
+    /**
+     * @param {number} minBackoff
+     * @returns {this}
+     */
+    setMinBackoff(minBackoff: number): this;
+    /**
+     * @returns {number}
+     */
+    get maxBackoff(): number;
+    /**
+     * @param {number} maxBackoff
+     * @returns {this}
+     */
+    setMaxBackoff(maxBackoff: number): this;
+    getChannel(): ChannelT;
+    __lastUsed: number | undefined;
+    /**
+     * Determines if this node is healthy by checking if this node hasn't been
+     * in use for a the required `_currentBackoff` period. Since this looks at `this._lastUsed`
+     * and that value is only set in the `wait()` method, any node that has not
+     * returned a bad gRPC status will always be considered healthy.
+     *
+     * @returns {boolean}
+     */
+    isHealthy(): boolean;
+    increaseBackoff(): void;
+    decreaseBackoff(): void;
+    /**
+     * @returns {number}
+     */
+    getRemainingTime(): number;
+    /**
+     * This is only ever called if the node itself is down.
+     * A node returning a transaction with a bad status code does not indicate
+     * the node is down, and hence this method will not be called.
+     *
+     * @returns {Promise<void>}
+     */
+    backoff(): Promise<void>;
+    /**
+     * @param {ManagedNode<*>} node
+     * @returns {number}
+     */
+    compare(node: ManagedNode<any>): number;
+    close(): void;
+}
+export type AccountId = import("./account/AccountId.js").default;
+export type Channel = import("./channel/Channel.js").default;
+export type MirrorChannel = import("./channel/MirrorChannel.js").default;
+export type NodeAddress = import("./address_book/NodeAddress.js").default;
+export type NewNode<ChannelT extends Channel | MirrorChannel> = {
+    address: string | ManagedNodeAddress;
+    channelInitFunction: (address: string, cert?: string) => ChannelT;
+};
+export type CloneNode<ChannelT extends Channel | MirrorChannel> = {
+    node: ManagedNode<ChannelT>;
+    address: ManagedNodeAddress;
+};
+import ManagedNodeAddress from "./ManagedNodeAddress.js";

package/lib/ManagedNode.js

@@ -0,0 +1,2 @@
+import e from"./ManagedNodeAddress.js";class t{constructor(t={}){if(null!=t.newNode)this._address="string"==typeof t.newNode.address?e.fromString(t.newNode.address):t.newNode.address,this._cert=void 0,this._channel=null,this._channelInitFunction=t.newNode.channelInitFunction,this._lastUsed=Date.now(),this._readmitTime=Date.now(),this._useCount=0,this._badGrpcStatusCount=0,this._minBackoff=8e3,this._maxBackoff=36e5,this._currentBackoff=this._minBackoff;else{if(null==t.cloneNode)throw new Error(`failed to create ManagedNode: ${JSON.stringify(t)}`);this._address=t.cloneNode.address,this._cert=t.cloneNode.node._cert,this._channel=t.cloneNode.node._channel,this._channelInitFunction=t.cloneNode.node._channelInitFunction,this._currentBackoff=t.cloneNode.node._currentBackoff,this._lastUsed=t.cloneNode.node._lastUsed,this._readmitTime=t.cloneNode.node._readmitTime,this._useCount=t.cloneNode.node._useCount,this._badGrpcStatusCount=t.cloneNode.node._badGrpcStatusCount,this._minBackoff=t.cloneNode.node._minBackoff,this._maxBackoff=t.cloneNode.node._minBackoff}}getKey(){throw new Error("not implemented")}setCert(e){return this}get address(){return this._address}get attempts(){return this._badGrpcStatusCount}get minBackoff(){return this._minBackoff}setMinBackoff(e){return this._currentBackoff<=e&&(this._currentBackoff=e),this._minBackoff=e,this}get maxBackoff(){return this._maxBackoff}setMaxBackoff(e){return this._currentBackoff<=e&&(this._currentBackoff=e),this._maxBackoff=e,this}getChannel(){return this._useCount++,this.__lastUsed=Date.now(),null!=this._channel||(this._channel=this._channelInitFunction(this.address.toString(),this._cert)),this._channel}isHealthy(){return this._readmitTime<=Date.now()}increaseBackoff(){this._currentBackoff=Math.min(2*this._currentBackoff,this._maxBackoff),this._readmitTime=Date.now()+this._currentBackoff}decreaseBackoff(){this._currentBackoff=Math.max(this._currentBackoff/2,this._minBackoff)}getRemainingTime(){return this._readmitTime-this._lastUsed}backoff(){return new Promise((e=>setTimeout(e,this.getRemainingTime())))}compare(e){let t=this.getRemainingTime()-e.getRemainingTime();return 0!=t?t:(t=this._currentBackoff-e._currentBackoff,0!=t?t:(t=this._badGrpcStatusCount-e._badGrpcStatusCount,0!=t?t:(t=this._useCount-e._useCount,0!=t?t:this._lastUsed-e._lastUsed)))}close(){null!=this._channel&&this._channel.close(),this._channel=null}}export{t as default};
+//# sourceMappingURL=ManagedNode.js.map