@hiero-ledger/sdk 2.70.0

package/lib/Cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.js","sources":["../src/Cache.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * @typedef {import(\"./contract/ContractId.js\").default} ContractId\n * @typedef {import(\"./account/AccountId.js\").default} AccountId\n * @typedef {import(\"./KeyList.js\").default} KeyList\n * @typedef {import(\"./PublicKey.js\").default} PublicKey\n * @typedef {import(\"./PrivateKey.js\").default} PrivateKey\n * @typedef {import(\"./Mnemonic.js\").default} Mnemonic\n * @typedef {import(\"./EvmAddress.js\").default} EvmAddress\n * @typedef {import(\"./EthereumTransactionData.js\").default} EthereumTransactionData\n * @typedef {import(\"./transaction/TransactionReceiptQuery.js\").default} TransactionReceiptQuery\n * @typedef {import(\"./transaction/TransactionRecordQuery.js\").default} TransactionRecordQuery\n * @typedef {import(\"./network/AddressBookQuery.js\").default} AddressBookQuery\n */\n\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.IKey} HieroProto.proto.IKey\n * @typedef {import(\"@hashgraph/proto\").proto.IKeyList} HieroProto.proto.IKeyList\n * @typedef {import(\"@hashgraph/proto\").proto.IThresholdKey} HieroProto.proto.IThresholdKey\n * @typedef {import(\"@hashgraph/proto\").proto.IContractID} HieroProto.proto.IContractID\n */\n\n/**\n * @namespace cryptography\n * @typedef {import(\"@hashgraph/cryptography\").PrivateKey} cryptography.PrivateKey\n * @typedef {import(\"@hashgraph/cryptography\").Mnemonic} cryptography.Mnemonic\n */\n\n/**\n * @template {object} ProtobufT\n * @template {object} SdkT\n * @typedef {{ (proto: ProtobufT): SdkT }} FromProtobufKeyFuncT\n */\n\n/**\n * Cache class is designed to prevent cyclic dependencies in the Hiero JavaScript SDK.\n * It stores various conversion functions and configuration values that are used across\n * different parts of the SDK.\n */\nclass Cache {\n    constructor() {\n        /** @type {number} */\n        this._timeDrift = 0;\n\n        /** @type {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId> | null} */\n        this._contractId = null;\n\n        /** @type {FromProtobufKeyFuncT<HieroProto.proto.IKeyList, KeyList> | null} */\n        this._keyList = null;\n\n        /** @type {FromProtobufKeyFuncT<HieroProto.proto.IThresholdKey, KeyList> | null} */\n        this._thresholdKey = null;\n\n        /** @type {FromProtobufKeyFuncT<Uint8Array, PublicKey> | null} */\n        this._publicKeyED25519 = null;\n\n        /** @type {FromProtobufKeyFuncT<Uint8Array, PublicKey> | null} */\n        this._publicKeyECDSA = null;\n\n        /** @type {((key: cryptography.PrivateKey) => PrivateKey) | null} */\n        this._privateKeyConstructor = null;\n\n        /** @type {((key: cryptography.Mnemonic) => Mnemonic) | null} */\n        this._mnemonicFromString = null;\n\n        /** @type {((shard: Long | number, realm: Long | number, key: PublicKey) => AccountId) | null} */\n        this._accountIdConstructor = null;\n\n        /** @type {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId> | null} */\n        this._delegateContractId = null;\n\n        /** @type {FromProtobufKeyFuncT<Uint8Array, EvmAddress> | null} */\n        this._evmAddress = null;\n\n        /** @type {((bytes: Uint8Array) => EthereumTransactionData) | null} */\n        this._ethereumTransactionDataLegacyFromBytes = null;\n\n        /** @type {((bytes: Uint8Array) => EthereumTransactionData) | null} */\n        this._ethereumTransactionDataEip1559FromBytes = null;\n\n        /** @type {((bytes: Uint8Array) => EthereumTransactionData) | null} */\n        this._ethereumTransactionDataEip2930FromBytes = null;\n\n        /** @type {(() => TransactionReceiptQuery) | null} */\n        this._transactionReceiptQueryConstructor = null;\n\n        /** @type {(() => TransactionRecordQuery) | null} */\n        this._transactionRecordQueryConstructor = null;\n    }\n\n    /**\n     * @param {number} timeDrift\n     */\n    setTimeDrift(timeDrift) {\n        this._timeDrift = timeDrift;\n    }\n\n    /**\n     * @returns {number}\n     */\n    get timeDrift() {\n        if (this._timeDrift == null) {\n            throw new Error(\"Cache.timeDrift was used before it was set\");\n        }\n\n        return this._timeDrift;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId>} contractId\n     */\n    setContractId(contractId) {\n        this._contractId = contractId;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId>}\n     */\n    get contractId() {\n        if (this._contractId == null) {\n            throw new Error(\"Cache.contractId was used before it was set\");\n        }\n\n        return this._contractId;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<HieroProto.proto.IKeyList, KeyList>} keyList\n     */\n    setKeyList(keyList) {\n        this._keyList = keyList;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<HieroProto.proto.IKeyList, KeyList>}\n     */\n    get keyList() {\n        if (this._keyList == null) {\n            throw new Error(\"Cache.keyList was used before it was set\");\n        }\n\n        return this._keyList;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<HieroProto.proto.IThresholdKey, KeyList>} thresholdKey\n     */\n    setThresholdKey(thresholdKey) {\n        this._thresholdKey = thresholdKey;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<HieroProto.proto.IThresholdKey, KeyList>}\n     */\n    get thresholdKey() {\n        if (this._thresholdKey == null) {\n            throw new Error(\"Cache.thresholdKey was used before it was set\");\n        }\n\n        return this._thresholdKey;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<Uint8Array, PublicKey>} publicKeyED25519\n     */\n    setPublicKeyED25519(publicKeyED25519) {\n        this._publicKeyED25519 = publicKeyED25519;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<Uint8Array, PublicKey>}\n     */\n    get publicKeyED25519() {\n        if (this._publicKeyED25519 == null) {\n            throw new Error(\n                \"Cache.publicKeyED25519 was used before it was set\",\n            );\n        }\n\n        return this._publicKeyED25519;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<Uint8Array, PublicKey>} publicKeyECDSA\n     */\n    setPublicKeyECDSA(publicKeyECDSA) {\n        this._publicKeyECDSA = publicKeyECDSA;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<Uint8Array, PublicKey>}\n     */\n    get publicKeyECDSA() {\n        if (this._publicKeyECDSA == null) {\n            throw new Error(\"Cache.publicKeyECDSA was used before it was set\");\n        }\n\n        return this._publicKeyECDSA;\n    }\n\n    /**\n     * @param {((key: cryptography.PrivateKey) => PrivateKey)} privateKeyConstructor\n     */\n    setPrivateKeyConstructor(privateKeyConstructor) {\n        this._privateKeyConstructor = privateKeyConstructor;\n    }\n\n    /**\n     * @returns {((key: cryptography.PrivateKey) => PrivateKey)}\n     */\n    get privateKeyConstructor() {\n        if (this._privateKeyConstructor == null) {\n            throw new Error(\n                \"Cache.privateKeyConstructor was used before it was set\",\n            );\n        }\n\n        return this._privateKeyConstructor;\n    }\n\n    /**\n     * @param {((key: cryptography.Mnemonic) => Mnemonic)} mnemonicFromString\n     */\n    setMnemonicFromString(mnemonicFromString) {\n        this._mnemonicFromString = mnemonicFromString;\n    }\n\n    /**\n     * @returns {((key: cryptography.PrivateKey) => PrivateKey)}\n     */\n    get mnemonicFromString() {\n        if (this._mnemonicFromString == null) {\n            throw new Error(\n                \"Cache.mnemonicFromString was used before it was set\",\n            );\n        }\n\n        return this.mnemonicFromString;\n    }\n\n    /**\n     * @param {((shard: Long | number, realm: Long | number, key: PublicKey) => AccountId)} accountIdConstructor\n     */\n    setAccountIdConstructor(accountIdConstructor) {\n        this._accountIdConstructor = accountIdConstructor;\n    }\n\n    /**\n     * @returns {((shard: Long | number, realm: Long | number, key: PublicKey) => AccountId)}\n     */\n    get accountIdConstructor() {\n        if (this._accountIdConstructor == null) {\n            throw new Error(\n                \"Cache.accountIdConstructor was used before it was set\",\n            );\n        }\n\n        return this._accountIdConstructor;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId>} delegateContractId\n     */\n    setDelegateContractId(delegateContractId) {\n        this._delegateContractId = delegateContractId;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<HieroProto.proto.IContractID, ContractId>}\n     */\n    get delegateContractId() {\n        if (this._delegateContractId == null) {\n            throw new Error(\n                \"Cache.delegateContractId was used before it was set\",\n            );\n        }\n\n        return this._delegateContractId;\n    }\n\n    /**\n     * @param {FromProtobufKeyFuncT<Uint8Array, EvmAddress>} evmAddress\n     */\n    setEvmAddress(evmAddress) {\n        this._evmAddress = evmAddress;\n    }\n\n    /**\n     * @returns {FromProtobufKeyFuncT<Uint8Array, EvmAddress>}\n     */\n    get evmAddress() {\n        if (this._evmAddress == null) {\n            throw new Error(\"Cache.evmAddress was used before it was set\");\n        }\n\n        return this._evmAddress;\n    }\n\n    /**\n     * @param {((bytes: Uint8Array) => EthereumTransactionData)} ethereumTransactionDataLegacyFromBytes\n     */\n    setEthereumTransactionDataLegacyFromBytes(\n        ethereumTransactionDataLegacyFromBytes,\n    ) {\n        this._ethereumTransactionDataLegacyFromBytes =\n            ethereumTransactionDataLegacyFromBytes;\n    }\n\n    /**\n     * @returns {((bytes: Uint8Array) => EthereumTransactionData)}\n     */\n    get ethereumTransactionDataLegacyFromBytes() {\n        if (this._ethereumTransactionDataLegacyFromBytes == null) {\n            throw new Error(\n                \"Cache.ethereumTransactionDataLegacyFromBytes was used before it was set\",\n            );\n        }\n\n        return this._ethereumTransactionDataLegacyFromBytes;\n    }\n\n    /**\n     * @param {((bytes: Uint8Array) => EthereumTransactionData)} ethereumTransactionDataEip1559FromBytes\n     */\n    setEthereumTransactionDataEip1559FromBytes(\n        ethereumTransactionDataEip1559FromBytes,\n    ) {\n        this._ethereumTransactionDataEip1559FromBytes =\n            ethereumTransactionDataEip1559FromBytes;\n    }\n\n    /**\n     * @returns {((bytes: Uint8Array) => EthereumTransactionData)}\n     */\n    get ethereumTransactionDataEip1559FromBytes() {\n        if (this._ethereumTransactionDataEip1559FromBytes == null) {\n            throw new Error(\n                \"Cache.ethereumTransactionDataEip1559FromBytes was used before it was set\",\n            );\n        }\n\n        return this._ethereumTransactionDataEip1559FromBytes;\n    }\n\n    /**\n     * @param {((bytes: Uint8Array) => EthereumTransactionData)} ethereumTransactionDataEip2930FromBytes\n     */\n    setEthereumTransactionDataEip2930FromBytes(\n        ethereumTransactionDataEip2930FromBytes,\n    ) {\n        this._ethereumTransactionDataEip2930FromBytes =\n            ethereumTransactionDataEip2930FromBytes;\n    }\n\n    /**\n     * @returns {((bytes: Uint8Array) => EthereumTransactionData)}\n     */\n    get ethereumTransactionDataEip2930FromBytes() {\n        if (this._ethereumTransactionDataEip2930FromBytes == null) {\n            throw new Error(\n                \"Cache.ethereumTransactionDataEip2930FromBytes was used before it was set\",\n            );\n        }\n\n        return this._ethereumTransactionDataEip2930FromBytes;\n    }\n\n    /**\n     * @param {(() => TransactionReceiptQuery)} transactionReceiptQueryConstructor\n     */\n    setTransactionReceiptQueryConstructor(transactionReceiptQueryConstructor) {\n        this._transactionReceiptQueryConstructor =\n            transactionReceiptQueryConstructor;\n    }\n\n    /**\n     * @returns {(() => TransactionReceiptQuery)}\n     */\n    get transactionReceiptQueryConstructor() {\n        if (this._transactionReceiptQueryConstructor == null) {\n            throw new Error(\n                \"Cache.transactionReceiptQueryConstructor was used before it was set\",\n            );\n        }\n\n        return this._transactionReceiptQueryConstructor;\n    }\n\n    /**\n     * @param {(() => TransactionRecordQuery)} transactionRecordQueryConstructor\n     */\n    setTransactionRecordQueryConstructor(transactionRecordQueryConstructor) {\n        this._transactionRecordQueryConstructor =\n            transactionRecordQueryConstructor;\n    }\n\n    /**\n     * @returns {(() => TransactionRecordQuery)}\n     */\n    get transactionRecordQueryConstructor() {\n        if (this._transactionRecordQueryConstructor == null) {\n            throw new Error(\n                \"Cache.transactionRecordQueryConstructor was used before it was set\",\n            );\n        }\n\n        return this._transactionRecordQueryConstructor;\n    }\n}\n\n/**\n * This variable is strictly designed to prevent cyclic dependencies.\n */\nconst CACHE = new Cache();\n\nexport default CACHE;\n"],"names":["CACHE","constructor","this","_timeDrift","_contractId","_keyList","_thresholdKey","_publicKeyED25519","_publicKeyECDSA","_privateKeyConstructor","_mnemonicFromString","_accountIdConstructor","_delegateContractId","_evmAddress","_ethereumTransactionDataLegacyFromBytes","_ethereumTransactionDataEip1559FromBytes","_ethereumTransactionDataEip2930FromBytes","_transactionReceiptQueryConstructor","_transactionRecordQueryConstructor","setTimeDrift","timeDrift","Error","setContractId","contractId","setKeyList","keyList","setThresholdKey","thresholdKey","setPublicKeyED25519","publicKeyED25519","setPublicKeyECDSA","publicKeyECDSA","setPrivateKeyConstructor","privateKeyConstructor","setMnemonicFromString","mnemonicFromString","setAccountIdConstructor","accountIdConstructor","setDelegateContractId","delegateContractId","setEvmAddress","evmAddress","setEthereumTransactionDataLegacyFromBytes","ethereumTransactionDataLegacyFromBytes","setEthereumTransactionDataEip1559FromBytes","ethereumTransactionDataEip1559FromBytes","setEthereumTransactionDataEip2930FromBytes","ethereumTransactionDataEip2930FromBytes","setTransactionReceiptQueryConstructor","transactionReceiptQueryConstructor","setTransactionRecordQueryConstructor","transactionRecordQueryConstructor"],"mappings":"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"}

package/lib/Duration.cjs

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _long = _interopRequireDefault(require("long"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.IDuration} HieroProto.proto.IDuration
+ */
+
+/**
+ * A duration type.
+ *
+ * The main point of this tyope is for encapsulating the `[to|from]Protobuf()` implementations
+ */
+class Duration {
+  /**
+   * @param {Long | number} seconds
+   */
+  constructor(seconds) {
+    /**
+     * @readonly
+     * @type {Long}
+     */
+    this.seconds = seconds instanceof _long.default ? seconds : _long.default.fromNumber(seconds);
+    Object.freeze(this);
+  }
+
+  /**
+   * @internal
+   * @returns {HieroProto.proto.IDuration}
+   */
+  _toProtobuf() {
+    return {
+      seconds: this.seconds
+    };
+  }
+
+  /**
+   * @internal
+   * @param {HieroProto.proto.IDuration} duration
+   * @returns {Duration}
+   */
+  static _fromProtobuf(duration) {
+    return new Duration(/** @type {Long} */duration.seconds);
+  }
+}
+exports.default = Duration;

package/lib/Duration.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @namespace proto
+ * @typedef {import("@hashgraph/proto").proto.IDuration} HieroProto.proto.IDuration
+ */
+/**
+ * A duration type.
+ *
+ * The main point of this tyope is for encapsulating the `[to|from]Protobuf()` implementations
+ */
+export default class Duration {
+    /**
+     * @internal
+     * @param {HieroProto.proto.IDuration} duration
+     * @returns {Duration}
+     */
+    static _fromProtobuf(duration: HieroProto.proto.IDuration): Duration;
+    /**
+     * @param {Long | number} seconds
+     */
+    constructor(seconds: Long | number);
+    /**
+     * @readonly
+     * @type {Long}
+     */
+    readonly seconds: Long;
+    /**
+     * @internal
+     * @returns {HieroProto.proto.IDuration}
+     */
+    _toProtobuf(): HieroProto.proto.IDuration;
+}
+export namespace HieroProto {
+    namespace proto {
+        type IDuration = import("@hashgraph/proto").proto.IDuration;
+    }
+}
+import Long from "long";

package/lib/Duration.js

@@ -0,0 +1,2 @@
+import o from"long";class s{constructor(s){this.seconds=s instanceof o?s:o.fromNumber(s),Object.freeze(this)}_toProtobuf(){return{seconds:this.seconds}}static _fromProtobuf(o){return new s(o.seconds)}}export{s as default};
+//# sourceMappingURL=Duration.js.map

package/lib/Duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Duration.js","sources":["../src/Duration.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport Long from \"long\";\n\n/**\n * @namespace proto\n * @typedef {import(\"@hashgraph/proto\").proto.IDuration} HieroProto.proto.IDuration\n */\n\n/**\n * A duration type.\n *\n * The main point of this tyope is for encapsulating the `[to|from]Protobuf()` implementations\n */\nexport default class Duration {\n    /**\n     * @param {Long | number} seconds\n     */\n    constructor(seconds) {\n        /**\n         * @readonly\n         * @type {Long}\n         */\n        this.seconds =\n            seconds instanceof Long ? seconds : Long.fromNumber(seconds);\n\n        Object.freeze(this);\n    }\n\n    /**\n     * @internal\n     * @returns {HieroProto.proto.IDuration}\n     */\n    _toProtobuf() {\n        return {\n            seconds: this.seconds,\n        };\n    }\n\n    /**\n     * @internal\n     * @param {HieroProto.proto.IDuration} duration\n     * @returns {Duration}\n     */\n    static _fromProtobuf(duration) {\n        return new Duration(/** @type {Long} */ (duration.seconds));\n    }\n}\n"],"names":["Duration","constructor","seconds","this","Long","fromNumber","Object","freeze","_toProtobuf","_fromProtobuf","duration"],"mappings":"oBAce,MAAMA,EAIjB,WAAAC,CAAYC,GAKRC,KAAKD,QACDA,aAAmBE,EAAOF,EAAUE,EAAKC,WAAWH,GAExDI,OAAOC,OAAOJ,KACtB,CAMI,WAAAK,GACI,MAAO,CACHN,QAASC,KAAKD,QAE1B,CAOI,oBAAOO,CAAcC,GACjB,OAAO,IAAIV,EAA8BU,EAAgB,QACjE"}

package/lib/EntityIdHelper.cjs

@@ -0,0 +1,547 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports._checksum = _checksum;
+exports._parseAddress = _parseAddress;
+exports.aliasToEvmAddress = aliasToEvmAddress;
+exports.aliasToPublicKey = aliasToPublicKey;
+exports.compare = compare;
+exports.constructor = constructor;
+exports.fromEvmAddress = fromEvmAddress;
+exports.fromSolidityAddress = fromSolidityAddress;
+exports.fromString = fromString;
+exports.fromStringSplitter = fromStringSplitter;
+exports.publicKeyToAlias = publicKeyToAlias;
+exports.toEvmAddress = toEvmAddress;
+exports.toSolidityAddress = toSolidityAddress;
+exports.toStringWithChecksum = toStringWithChecksum;
+exports.validateChecksum = validateChecksum;
+var _long = _interopRequireDefault(require("long"));
+var hex = _interopRequireWildcard(require("./encoding/hex.cjs"));
+var _BadEntityIdError = _interopRequireDefault(require("./BadEntityIdError.cjs"));
+var util = _interopRequireWildcard(require("./util.cjs"));
+var _base = _interopRequireDefault(require("./base32.cjs"));
+var HieroProto = _interopRequireWildcard(require("@hashgraph/proto"));
+var _PublicKey = _interopRequireDefault(require("./PublicKey.cjs"));
+var _bytes = require("@ethersproject/bytes");
+var _EvmAddress = _interopRequireDefault(require("./EvmAddress.cjs"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * @typedef {import("./client/Client.js").default<*, *>} Client
+ */
+
+/**
+ * @typedef {object} IEntityId
+ * @property {number | Long} num
+ * @property {(number | Long)=} shard
+ * @property {(number | Long)=} realm
+ */
+
+/**
+ * @typedef {object} IEntityIdResult
+ * @property {Long} shard
+ * @property {Long} realm
+ * @property {Long} num
+ */
+
+/**
+ * @typedef {object} IEntityIdParts
+ * @property {string?} shard
+ * @property {string?} realm
+ * @property {string} numOrHex
+ * @property {string?} checksum
+ */
+
+/**
+ * @typedef {object} IEntityIdResultWithChecksum
+ * @property {Long} shard
+ * @property {Long} realm
+ * @property {Long} num
+ * @property {string | null} checksum
+ */
+
+const regex = /"^(0|(?:[1-9]\\d*))\\.(0|(?:[1-9]\\d*))\\.(0|(?:[1-9]\\d*))(?:-([a-z]{5}))?$/;
+
+/**
+ * This regex supports entity IDs
+ *  - as stand alone nubmers
+ *  - as shard.realm.num
+ *  - as shard.realm.hex
+ *  - can optionally provide checksum for any of the above
+ */
+const ENTITY_ID_REGEX = /^(\d+)(?:\.(\d+)\.([a-fA-F0-9]+))?(?:-([a-z]{5}))?$/;
+
+/**
+ * @description The length of an EVM address in bytes.
+ */
+const EVM_ADDRESS_LENGTH = 20;
+
+/**
+ * @description The length of the long-zero prefix in bytes.
+ */
+const LONG_ZERO_PREFIX_LENGTH = 12;
+
+/**
+ * @description The offset of the entity number in the EVM address.
+ */
+const ENTITY_NUM_OFFSET = 16;
+
+/**
+ * This method is called by most entity ID constructors. It's purpose is to
+ * deduplicate the constuctors.
+ *
+ * @param {number | Long | IEntityId} props
+ * @param {(number | null | Long)=} realmOrNull
+ * @param {(number | null | Long)=} numOrNull
+ * @returns {IEntityIdResult}
+ */
+function constructor(props, realmOrNull, numOrNull) {
+  // Make sure either both the second and third parameter are
+  // set or not set; we shouldn't have one set, but the other not set.
+  //
+  //NOSONAR
+  if (realmOrNull == null && numOrNull != null || realmOrNull != null && numOrNull == null) {
+    throw new Error("invalid entity ID");
+  }
+
+  // If the first parameter is a number then we need to convert the
+  // first, second, and third parameters into numbers. Otherwise,
+  // we should look at the fields `shard`, `realm`, and `num` on
+  // `props`
+  const [shard, realm, num] = typeof props === "number" || _long.default.isLong(props) ? [numOrNull != null ? _long.default.fromValue(/** @type {Long | number} */props) : _long.default.ZERO, realmOrNull != null ? _long.default.fromValue(realmOrNull) : _long.default.ZERO, numOrNull != null ? _long.default.fromValue(numOrNull) : _long.default.fromValue(/** @type {Long | number} */props)] : [props.shard != null ? _long.default.fromValue(props.shard) : _long.default.ZERO, props.realm != null ? _long.default.fromValue(props.realm) : _long.default.ZERO, _long.default.fromValue(props.num)];
+
+  // Make sure none of the numbers are negative
+  if (shard.isNegative() || realm.isNegative() || num.isNegative()) {
+    throw new Error("negative numbers are not allowed in IDs");
+  }
+  return {
+    shard,
+    realm,
+    num
+  };
+}
+
+/**
+ * A simple comparison function for comparing entity IDs
+ *
+ * @param {[Long, Long, Long]} a
+ * @param {[Long, Long, Long]} b
+ * @returns {number}
+ */
+function compare(a, b) {
+  let comparison = a[0].compare(b[0]);
+  if (comparison != 0) {
+    return comparison;
+  }
+  comparison = a[1].compare(b[1]);
+  if (comparison != 0) {
+    return comparison;
+  }
+  return a[2].compare(b[2]);
+}
+
+/**
+ * This type is part of the entity ID checksums feature which
+ * is responsible for checking if an entity ID was created on
+ * the same ledger ID as the client is currently using.
+ *
+ * @typedef {object} ParseAddressResult
+ * @property {number} status
+ * @property {Long} [num1]
+ * @property {Long} [num2]
+ * @property {Long} [num3]
+ * @property {string} [correctChecksum]
+ * @property {string} [givenChecksum]
+ * @property {string} [noChecksumFormat]
+ * @property {string} [withChecksumFormat]
+ */
+
+/**
+ * @param {string} text
+ * @returns {IEntityIdParts}
+ */
+function fromStringSplitter(text) {
+  const match = ENTITY_ID_REGEX.exec(text);
+  if (match == null) {
+    throw new Error(`failed to parse entity id: ${text}`);
+  }
+  if (match[2] == null && match[3] == null) {
+    return {
+      shard: "0",
+      realm: "0",
+      numOrHex: match[1],
+      checksum: match[4]
+    };
+  } else {
+    return {
+      shard: match[1],
+      realm: match[2],
+      numOrHex: match[3],
+      checksum: match[4]
+    };
+  }
+}
+
+/**
+ * @param {string} text
+ * @returns {IEntityIdResultWithChecksum}
+ */
+function fromString(text) {
+  const result = fromStringSplitter(text);
+  if (Number.isNaN(result.shard) || Number.isNaN(result.realm) || Number.isNaN(result.numOrHex)) {
+    throw new Error("invalid format for entity ID");
+  }
+  return {
+    shard: result.shard != null ? _long.default.fromString(result.shard) : _long.default.ZERO,
+    realm: result.realm != null ? _long.default.fromString(result.realm) : _long.default.ZERO,
+    num: _long.default.fromString(result.numOrHex),
+    checksum: result.checksum
+  };
+}
+
+/**
+ * Return the shard, realm, and num from a solidity address.
+ *
+ * Solidity addresses are 20 bytes long and hex encoded, where the first 4
+ * bytes represent the shard, the next 8 bytes represent the realm, and
+ * the last 8 bytes represent the num. All in Big Endian format
+ *
+ * @param {string} address
+ * @returns {[Long, Long, Long]}
+ */
+function fromSolidityAddress(address) {
+  const addr = address.startsWith("0x") ? hex.decode(address.slice(2)) : hex.decode(address);
+  if (addr.length !== EVM_ADDRESS_LENGTH) {
+    throw new Error(`Invalid hex encoded solidity address length:
+                expected length 40, got length ${address.length}`);
+  }
+  const shard = _long.default.fromBytesBE([0, 0, 0, 0, ...addr.slice(0, 4)]);
+  const realm = _long.default.fromBytesBE(Array.from(addr.slice(4, 12)));
+  const num = _long.default.fromBytesBE(Array.from(addr.slice(12, 20)));
+  return [shard, realm, num];
+}
+
+/**
+ * Parse an EVM address and return shard, realm, entity num, and optional EVM address.
+ *
+ * For long zero addresses (first 12 bytes are zeros): returns [shard, realm, entityNum, null]
+ * For regular EVM addresses: returns [shard, realm, 0, EvmAddress]
+ *
+ * @param {Long | number} shard - The shard number to use
+ * @param {Long | number} realm - The realm number to use
+ * @param {string} address - The EVM address to parse (with or without 0x prefix)
+ * @returns {[Long, Long, Long, EvmAddress | null]} - [shard, realm, entityNum, evmAddressOrNull]
+ */
+function fromEvmAddress(shard, realm, address) {
+  if (!hex.isHexString(address)) {
+    throw new Error(`Invalid EVM address hex string: ${address}`);
+  }
+  const addr = address.startsWith("0x") ? hex.decode(address.slice(2)) : hex.decode(address);
+  if (addr.length !== EVM_ADDRESS_LENGTH) {
+    throw new Error(`Invalid hex encoded evm address length:
+                expected length ${EVM_ADDRESS_LENGTH}, got length ${address.length}`);
+  }
+  let num = _long.default.ZERO;
+  if (util.isLongZeroAddress(addr)) {
+    num = _long.default.fromBytesBE(Array.from(addr.slice(LONG_ZERO_PREFIX_LENGTH, EVM_ADDRESS_LENGTH)));
+  }
+  let shardLong = shard instanceof _long.default ? shard : _long.default.fromNumber(shard);
+  let realmLong = realm instanceof _long.default ? realm : _long.default.fromNumber(realm);
+  return [shardLong, realmLong, num, num.isZero() ? _EvmAddress.default.fromBytes(addr) : null];
+}
+
+/**
+ * Convert shard, realm, and num into a solidity address.
+ *
+ * See `fromSolidityAddress()` for more documentation.
+ *
+ * @param {[Long,Long,Long] | [number,number,number]} address
+ * @returns {string}
+ */
+function toSolidityAddress(address) {
+  const buffer = new Uint8Array(20);
+  const view = util.safeView(buffer);
+  const [shard, realm, num] = address;
+  view.setUint32(0, util.convertToNumber(shard));
+  view.setUint32(8, util.convertToNumber(realm));
+  view.setUint32(16, util.convertToNumber(num));
+  return hex.encode(buffer);
+}
+
+/**
+ * @overload
+ * @param {Uint8Array} evmAddressBytes - EVM address bytes to convert to hex
+ * @returns {string}
+ */
+
+/**
+ * @overload
+ * @param {Long} accountNum - Account number to convert to long-zero EVM address
+ * @returns {string}
+ */
+
+/**
+ * Convert EVM address bytes to hex string or account num to long-zero EVM address.
+ *
+ * @param {Uint8Array | Long} evmAddressBytesOrAccountNum
+ * @returns {string}
+ */
+function toEvmAddress(evmAddressBytesOrAccountNum) {
+  if (evmAddressBytesOrAccountNum instanceof Uint8Array) {
+    return hex.encode(evmAddressBytesOrAccountNum);
+  }
+  const accountNum = evmAddressBytesOrAccountNum;
+  const buffer = new Uint8Array(EVM_ADDRESS_LENGTH);
+  const view = util.safeView(buffer);
+  view.setUint32(ENTITY_NUM_OFFSET, util.convertToNumber(accountNum));
+  return hex.encode(buffer);
+}
+
+/**
+ * Parse the address string addr and return an object with the results (8 fields).
+ * The first four fields are numbers, which could be implemented as signed 32 bit
+ * integers, and the last four are strings.
+ *
+ *   status;  //the status of the parsed address
+ *            //   0 = syntax error
+ *            //   1 = an invalid with-checksum address (bad checksum)
+ *            //   2 = a valid no-checksum address
+ *            //   3 = a valid with-checksum address
+ *   num1;    //the 3 numbers in the address, such as 1.2.3, with leading zeros removed
+ *   num2;
+ *   num3;
+ *   correctchecksum;    //the correct checksum
+ *   givenChecksum;      //the checksum in the address that was parsed
+ *   noChecksumFormat;   //the address in no-checksum format
+ *   withChecksumFormat; //the address in with-checksum format
+ *
+ * @param {Uint8Array} ledgerId
+ * @param {string} addr
+ * @returns {ParseAddressResult}
+ */
+function _parseAddress(ledgerId, addr) {
+  let match = regex.exec(addr);
+  if (match === null) {
+    let result = {
+      status: 0
+    }; // When status == 0, the rest of the fields should be ignored
+    return result;
+  }
+  let a = [_long.default.fromString(match[1]), _long.default.fromString(match[2]), _long.default.fromString(match[3])];
+  let ad = `${a[0].toString()}.${a[1].toString()}.${a[2].toString()}`;
+  let c = _checksum(ledgerId, ad);
+  let s = match[4] === undefined ? 2 : c == match[4] ? 3 : 1; //NOSONAR
+  return {
+    status: s,
+    num1: a[0],
+    num2: a[1],
+    num3: a[2],
+    givenChecksum: match[4],
+    correctChecksum: c,
+    noChecksumFormat: ad,
+    withChecksumFormat: `${ad}-${c}`
+  };
+}
+
+/**
+ * Given an address like "0.0.123", return a checksum like "laujm"
+ *
+ * @param {Uint8Array} ledgerId
+ * @param {string} addr
+ * @returns {string}
+ */
+function _checksum(ledgerId, addr) {
+  let answer = "";
+  let d = []; // Digits with 10 for ".", so if addr == "0.0.123" then d == [0, 10, 0, 10, 1, 2, 3]
+  let s0 = 0; // Sum of even positions (mod 11)
+  let s1 = 0; // Sum of odd positions (mod 11)
+  let s = 0; // Weighted sum of all positions (mod p3)
+  let sh = 0; // Hash of the ledger ID
+  let c = 0; // The checksum, as a single number
+  const p3 = 26 * 26 * 26; // 3 digits in base 26
+  const p5 = 26 * 26 * 26 * 26 * 26; // 5 digits in base 26
+  const ascii_a = "a".charCodeAt(0); // 97
+  const m = 1000003; // Min prime greater than a million. Used for the final permutation.
+  const w = 31; // Sum s of digit values weights them by powers of w. Should be coprime to p5.
+
+  let h = new Uint8Array(ledgerId.length + 6);
+  h.set(ledgerId, 0);
+  h.set([0, 0, 0, 0, 0, 0], ledgerId.length);
+  for (let i = 0; i < addr.length; i++) {
+    //NOSONAR
+    d.push(addr[i] === "." ? 10 : parseInt(addr[i], 10));
+  }
+  for (let i = 0; i < d.length; i++) {
+    s = (w * s + d[i]) % p3;
+    if (i % 2 === 0) {
+      s0 = (s0 + d[i]) % 11;
+    } else {
+      s1 = (s1 + d[i]) % 11;
+    }
+  }
+  for (let i = 0; i < h.length; i++) {
+    sh = (w * sh + h[i]) % p5;
+  }
+  c = (((addr.length % 5 * 11 + s0) * 11 + s1) * p3 + s + sh) % p5;
+  c = c * m % p5;
+  for (let i = 0; i < 5; i++) {
+    answer = String.fromCharCode(ascii_a + c % 26) + answer;
+    c /= 26;
+  }
+  return answer;
+}
+
+/**
+ * Validate an entity ID checksum against a client
+ *
+ * @param {Long} shard
+ * @param {Long} realm
+ * @param {Long} num
+ * @param {string | null} checksum
+ * @param {Client} client
+ */
+function validateChecksum(shard, realm, num, checksum, client) {
+  if (client._network._ledgerId == null || checksum == null) {
+    return;
+  }
+  const expectedChecksum = _checksum(client._network._ledgerId._ledgerId, `${shard.toString()}.${realm.toString()}.${num.toString()}`);
+  if (checksum != expectedChecksum) {
+    throw new _BadEntityIdError.default(shard, realm, num, checksum, expectedChecksum);
+  }
+}
+
+/**
+ * Stringify the entity ID with a checksum.
+ *
+ * @param {string} string
+ * @param {Client} client
+ * @returns {string}
+ */
+function toStringWithChecksum(string, client) {
+  if (client == null) {
+    throw new Error("client cannot be null");
+  }
+  if (client._network._ledgerId == null) {
+    throw new Error("cannot calculate checksum with a client that does not contain a recognzied ledger ID");
+  }
+  const checksum = _checksum(client._network._ledgerId._ledgerId, string);
+  return `${string}-${checksum}`;
+}
+
+/**
+ * Append Buffers.
+ * @param {Uint8Array} buffer1
+ * @param {Uint8Array} buffer2
+ * @returns {Uint8Array}
+ */
+function appendBuffer(buffer1, buffer2) {
+  var tmp = new Uint8Array(buffer1.byteLength + buffer2.byteLength);
+  tmp.set(new Uint8Array(buffer1), 0);
+  tmp.set(new Uint8Array(buffer2), buffer1.byteLength);
+  return tmp;
+}
+
+/**
+ * Convert bytes to hex string.
+ * @param {Uint8Array} bytes
+ * @returns {string}
+ */
+function toHexString(bytes) {
+  var s = "0x";
+  bytes.forEach(function (byte) {
+    s += ("0" + (byte & 0xff).toString(16)).slice(-2);
+  });
+  return s;
+}
+
+/**
+ * Deserialize the alias to public key.
+ * Alias is created from ed25519 or ECDSASecp256k1 types of accounts. If hollow account is used, the alias is created from evm address.
+ * For hollow accounts, please use aliasToEvmAddress.
+ *
+ * @param {string} alias
+ * @returns {PublicKey | null}
+ */
+function aliasToPublicKey(alias) {
+  const bytes = _base.default.decode(alias);
+  if (!bytes) {
+    return null;
+  }
+  let key;
+  try {
+    key = HieroProto.proto.Key.decode(bytes);
+  } catch (e) {
+    throw new Error("The alias is created with hollow account. Please use aliasToEvmAddress!");
+  }
+  if (key.ed25519 != null && key.ed25519.byteLength > 0) {
+    return _PublicKey.default.fromBytes(key.ed25519);
+  }
+  if (key.ECDSASecp256k1 != null && key.ECDSASecp256k1.byteLength > 0) {
+    return _PublicKey.default.fromBytes(key.ECDSASecp256k1);
+  }
+  return null;
+}
+
+/**
+ * Deserialize the alias to evm address.
+ * Alias is created from hollow account.
+ * For ed25519 or ECDSASecp256k1 accounts, please use aliasToPublicKey.
+ *
+ * @param {string} alias
+ * @returns {string | null}
+ */
+function aliasToEvmAddress(alias) {
+  const bytes = _base.default.decode(alias);
+  if (!bytes) {
+    return null;
+  }
+  try {
+    HieroProto.proto.Key.decode(bytes);
+    throw new Error("The alias is created with ed25519 or ECDSASecp256k1 account. Please use aliasToPublicKey!");
+  } catch (e) {
+    return toHexString(bytes);
+  }
+}
+
+/**
+ * Serialize the public key to alias.
+ * Alias is created from ed25519 or ECDSASecp256k1 types of accounts. If hollow account is used, the alias is created from evm address.
+ *
+ * @param {string | PublicKey} publicKey
+ * @returns {string | null}
+ */
+function publicKeyToAlias(publicKey) {
+  if (typeof publicKey === "string" && (publicKey.startsWith("0x") && publicKey.length == 42 || publicKey.length == 40)) {
+    if (!publicKey.startsWith("0x")) {
+      publicKey = `0x${publicKey}`;
+    }
+    const bytes = (0, _bytes.arrayify)(publicKey);
+    if (!bytes) {
+      return null;
+    }
+    return _base.default.encode(bytes);
+  }
+  const publicKeyRaw = typeof publicKey === "string" ? _PublicKey.default.fromString(publicKey) : publicKey;
+  let publicKeyHex = publicKeyRaw.toStringRaw();
+  let leadingHex = "";
+  if (publicKeyRaw._key._type === "secp256k1") {
+    leadingHex = "0x3A21"; // LEADING BYTES FROM PROTOBUFS
+  }
+  if (publicKeyRaw._key._type === "ED25519") {
+    leadingHex = "0x1220"; // LEADING BYTES FROM PROTOBUFS
+  }
+  if (!publicKeyHex.startsWith("0x")) {
+    publicKeyHex = `0x${publicKeyHex}`;
+  }
+  const leadingBytes = (0, _bytes.arrayify)(leadingHex);
+  const publicKeyBytes = (0, _bytes.arrayify)(publicKeyHex);
+  const publicKeyInBytes = appendBuffer(leadingBytes, publicKeyBytes);
+  const alias = _base.default.encode(publicKeyInBytes);
+  return alias;
+}