@hiero-ledger/sdk 2.70.0

package/lib/util.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Takes any param and returns false if null or undefined.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isNonNull(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param variable and type are the same.
+ *
+ * @param {any | null | undefined} variable
+ * @param {any | null | undefined} type
+ * @returns {boolean}
+ */
+export function isType(variable: any | null | undefined, type: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and of type Uint8Array.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isUint8Array(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and of type Number.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isNumber(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and of type BigNumber.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isBigNumber(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and of type BigNumber.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isLong(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and of type string.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isString(variable: any | null | undefined): boolean;
+/**
+ * Takes any param and returns true if param is not null and type string or Uint8Array.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {boolean}
+ */
+export function isStringOrUint8Array(variable: any | null | undefined): boolean;
+/**
+ * Takes an address as `Uint8Array` and returns whether or not this is a long-zero address
+ *
+ * @param {Uint8Array} address
+ * @returns {boolean}
+ */
+export function isLongZeroAddress(address: Uint8Array): boolean;
+/**
+ * Takes any param and returns false if null or undefined.
+ *
+ * @template {Long | Hbar} T
+ * @param {T} variable
+ * @returns {T}
+ */
+export function requireNotNegative<T extends Long | Hbar>(variable: T): T;
+/**
+ * Takes any param and throws custom error if null or undefined.
+ *
+ * @param {any} variable
+ * @returns {object}
+ */
+export function requireNonNull(variable: any): object;
+/**
+ * Takes any param and throws custom error if params are not same type.
+ *
+ * @param {any | null | undefined} variable
+ * @param {any | null | undefined} type
+ * @returns {object}
+ */
+export function requireType(variable: any | null | undefined, type: any | null | undefined): object;
+/**
+ * Takes any param and throws custom error if non BigNumber.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {BigNumber}
+ */
+export function requireBigNumber(variable: any | null | undefined): BigNumber;
+/**
+ * Takes any param and throws custom error if non BigNumber.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {Long}
+ */
+export function requireLong(variable: any | null | undefined): Long;
+/**
+ * Takes any param and throws custom error if non string.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {string}
+ */
+export function requireString(variable: any | null | undefined): string;
+/**
+ * Takes any param and throws custom error if non Uint8Array.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {Uint8Array}
+ */
+export function requireUint8Array(variable: any | null | undefined): Uint8Array;
+/**
+ * Takes any param and throws custom error if non Uint8Array.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {number}
+ */
+export function requireNumber(variable: any | null | undefined): number;
+/**
+ * Takes any param and throws custom error if null or undefined and not a string or Uint8Array.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {string | Uint8Array}
+ */
+export function requireStringOrUint8Array(variable: any | null | undefined): string | Uint8Array;
+/**
+ * Converts number or string to BigNumber.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {BigNumber}
+ */
+export function convertToBigNumber(variable: any | null | undefined): BigNumber;
+/**
+ * Converts Array of Numbers or Strings to Array of BigNumbers.
+ *
+ * @param {any | null | undefined} variable
+ * @returns {Array<BigNumber>}
+ */
+export function convertToBigNumberArray(variable: any | null | undefined): Array<BigNumber>;
+/**
+ * @param {*} variable
+ * @returns {number}
+ */
+export function convertToNumber(variable: any): number;
+/**
+ * Creates a DataView on top of an Uint8Array that could be or not be pooled, ensuring that we don't get out of bounds.
+ *
+ * @param {Uint8Array | Int8Array} arr
+ * @param {number | undefined} offset
+ * @param {number | undefined} length
+ * @returns {DataView}
+ */
+export function safeView(arr: Uint8Array | Int8Array, offset?: number | undefined, length?: number | undefined): DataView;
+/**
+ * @param {any} a
+ * @param {any} b
+ * @param {Set<string>=} ignore
+ * @returns {boolean}
+ */
+export function compare(a: any, b: any, ignore?: Set<string> | undefined): boolean;
+/**
+ * https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array
+ *
+ * @template T
+ * @param {Array<T>} array
+ */
+export function shuffle<T>(array: Array<T>): void;
+/**
+ * @param {Uint8Array} array1
+ * @param {Uint8Array} array2
+ * @returns {boolean}
+ */
+export function arrayEqual(array1: Uint8Array, array2: Uint8Array): boolean;
+/**
+ * @description Function that delays an execution for a given time (in milliseconds)
+ * @param {number} ms
+ * @returns {Promise<void>}
+ */
+export function wait(ms: number): Promise<void>;
+/**
+ * Converts a SCREAMING_SNAKE_CASE string to PascalCase
+ * @param {string} name - The string to convert
+ * @returns {string} The converted PascalCase string
+ */
+export function screamingSnakeToPascalCase(name: string): string;
+/**
+ * @typedef {import("./Hbar.js").default} Hbar
+ */
+/**
+ * Utility Error Messages
+ */
+export const REQUIRE_NON_NULL_ERROR: "This value cannot be null | undefined.";
+export const REQUIRE_STRING_ERROR: "This value must be a string.";
+export const REQUIRE_UINT8ARRAY_ERROR: "This value must be a Uint8Array.";
+export const REQUIRE_STRING_OR_UINT8ARRAY_ERROR: "This value must be a string or Uint8Array.";
+export const REQUIRE_NUMBER_ERROR: "This value must be a Number.";
+export const REQUIRE_BIGNUMBER_ERROR: "This value must be a BigNumber.";
+export const REQUIRE_ARRAY_ERROR: "The provided variable must be an Array.";
+export const REQUIRE_LONG_ERROR: "This value must be a Long.";
+export const REQUIRE_TYPE_ERROR: "The provided variables are not matching types.";
+export const FUNCTION_CONVERT_TO_BIGNUMBER_ERROR: "This value must be a String, Number, or BigNumber to be converted.";
+export const FUNCTION_CONVERT_TO_NUMBER_ERROR: "This value must be a String, Number, or BigNumber to be converted.";
+export const FUNCTION_CONVERT_TO_NUMBER_PARSE_ERROR: "Unable to parse given variable. Returns NaN.";
+export type Hbar = import("./Hbar.js").default;
+import Long from "long";
+import BigNumber from "bignumber.js";

package/lib/util.js

@@ -0,0 +1,2 @@
+import e from"bignumber.js";import t from"long";const n="This value cannot be null | undefined.",r="This value must be a string or Uint8Array.",o="The provided variable must be an Array.",i="This value must be a String, Number, or BigNumber to be converted.",f="This value must be a String, Number, or BigNumber to be converted.",u="Unable to parse given variable. Returns NaN.";function a(e){return null!=e}function b(e){return a(e)&&e instanceof Uint8Array}function s(e){return a(e)&&("number"==typeof e||e instanceof Number)}function c(t){return a(t)&&t instanceof e}function h(e){return a(e)&&e instanceof t}function g(e){return a(e)&&"string"==typeof e}function l(e){return a(e)&&(g(e)||b(e))}function w(e){for(let t=0;t<12;t++)if(0!=e[t])return!1;return!0}function y(e){if(e.isNegative())throw new Error("negative value not allowed");return e}function m(e){if(a(e))return e;throw new Error(n)}function p(e){if(l(m(e)))return e;throw new Error(r)}function v(t){if(m(t),c(t)||g(t)||s(t)||h(t))return new e(t);throw new Error(i)}function N(e){if(e instanceof Array)return e.map(v);throw new Error(o)}function d(e){if(m(e),c(e)||g(e)||s(e)||h(e)){const t=parseInt(e);if(isNaN(t))throw new Error(u);return t}throw new Error(f)}function E(e,t=0,n=e.byteLength){if(!(Number.isInteger(t)&&t>=0))throw new Error("Invalid offset!");if(!(Number.isInteger(n)&&n>=0))throw new Error("Invalid length!");return new DataView(e.buffer,e.byteOffset+t,Math.min(n,e.byteLength-t))}function L(e,t,n=new Set){if("object"==typeof e&&"object"==typeof t){const r=Object.keys(e),o=Object.keys(t);if(r.length!==o.length)return!1;for(let i=0;i<r.length;i++){if(r[i]!==o[i])return!1;if(!n.has(r[i])&&!L(e[r[i]],t[o[i]],n))return!1}return!0}return("number"==typeof e&&"number"==typeof t||"string"==typeof e&&"string"==typeof t||"boolean"==typeof e&&"boolean"==typeof t)&&e===t}function T(e){for(var t,n,r=e.length;0!==r;)n=Math.floor(Math.random()*r),t=e[r-=1],e[r]=e[n],e[n]=t}function j(e,t){if(e===t)return!0;if(e.byteLength!==t.byteLength)return!1;const n=new DataView(e.buffer,e.byteOffset,e.byteLength),r=new DataView(t.buffer,t.byteOffset,t.byteLength);let o=e.byteLength;for(;o--;)if(n.getUint8(o)!==r.getUint8(o))return!1;return!0}function I(e){return new Promise((t=>setTimeout(t,e)))}export{i as FUNCTION_CONVERT_TO_BIGNUMBER_ERROR,f as FUNCTION_CONVERT_TO_NUMBER_ERROR,u as FUNCTION_CONVERT_TO_NUMBER_PARSE_ERROR,o as REQUIRE_ARRAY_ERROR,n as REQUIRE_NON_NULL_ERROR,r as REQUIRE_STRING_OR_UINT8ARRAY_ERROR,j as arrayEqual,L as compare,v as convertToBigNumber,N as convertToBigNumberArray,d as convertToNumber,c as isBigNumber,h as isLong,w as isLongZeroAddress,a as isNonNull,s as isNumber,g as isString,l as isStringOrUint8Array,b as isUint8Array,m as requireNonNull,y as requireNotNegative,p as requireStringOrUint8Array,E as safeView,T as shuffle,I as wait};
+//# sourceMappingURL=util.js.map

package/lib/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sources":["../src/util.js"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\nimport BigNumber from \"bignumber.js\";\nimport Long from \"long\";\n\n/**\n * @typedef {import(\"./Hbar.js\").default} Hbar\n */\n\n/**\n * Utility Error Messages\n */\nexport const REQUIRE_NON_NULL_ERROR = \"This value cannot be null | undefined.\";\nexport const REQUIRE_STRING_ERROR = \"This value must be a string.\";\nexport const REQUIRE_UINT8ARRAY_ERROR = \"This value must be a Uint8Array.\";\nexport const REQUIRE_STRING_OR_UINT8ARRAY_ERROR =\n    \"This value must be a string or Uint8Array.\";\nexport const REQUIRE_NUMBER_ERROR = \"This value must be a Number.\";\nexport const REQUIRE_BIGNUMBER_ERROR = \"This value must be a BigNumber.\";\nexport const REQUIRE_ARRAY_ERROR = \"The provided variable must be an Array.\";\nexport const REQUIRE_LONG_ERROR = \"This value must be a Long.\";\n\nexport const REQUIRE_TYPE_ERROR =\n    \"The provided variables are not matching types.\";\n\nexport const FUNCTION_CONVERT_TO_BIGNUMBER_ERROR =\n    \"This value must be a String, Number, or BigNumber to be converted.\";\nexport const FUNCTION_CONVERT_TO_NUMBER_ERROR =\n    \"This value must be a String, Number, or BigNumber to be converted.\";\nexport const FUNCTION_CONVERT_TO_NUMBER_PARSE_ERROR =\n    \"Unable to parse given variable. Returns NaN.\";\n\n//Soft Checks\n\n/**\n * Takes any param and returns false if null or undefined.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isNonNull(variable) {\n    return variable != null;\n}\n\n/**\n * Takes any param and returns true if param variable and type are the same.\n *\n * @param {any | null | undefined} variable\n * @param {any | null | undefined} type\n * @returns {boolean}\n */\nexport function isType(variable, type) {\n    return typeof variable == typeof type;\n}\n\n/**\n * Takes any param and returns true if param is not null and of type Uint8Array.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isUint8Array(variable) {\n    return isNonNull(variable) && variable instanceof Uint8Array;\n}\n\n/**\n * Takes any param and returns true if param is not null and of type Number.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isNumber(variable) {\n    return (\n        isNonNull(variable) &&\n        (typeof variable == \"number\" || variable instanceof Number)\n    );\n}\n\n/**\n * Takes any param and returns true if param is not null and of type BigNumber.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isBigNumber(variable) {\n    return isNonNull(variable) && variable instanceof BigNumber;\n}\n\n/**\n * Takes any param and returns true if param is not null and of type BigNumber.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isLong(variable) {\n    return isNonNull(variable) && variable instanceof Long;\n}\n\n/**\n * Takes any param and returns true if param is not null and of type string.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isString(variable) {\n    return isNonNull(variable) && typeof variable == \"string\";\n}\n\n/**\n * Takes any param and returns true if param is not null and type string or Uint8Array.\n *\n * @param {any | null | undefined} variable\n * @returns {boolean}\n */\nexport function isStringOrUint8Array(variable) {\n    return (\n        isNonNull(variable) && (isString(variable) || isUint8Array(variable))\n    );\n}\n\n/**\n * Takes an address as `Uint8Array` and returns whether or not this is a long-zero address\n *\n * @param {Uint8Array} address\n * @returns {boolean}\n */\nexport function isLongZeroAddress(address) {\n    for (let i = 0; i < 12; i++) {\n        if (address[i] != 0) {\n            return false;\n        }\n    }\n    return true;\n}\n\n/**\n * Takes any param and returns false if null or undefined.\n *\n * @template {Long | Hbar} T\n * @param {T} variable\n * @returns {T}\n */\nexport function requireNotNegative(variable) {\n    if (variable.isNegative()) {\n        throw new Error(\"negative value not allowed\");\n    }\n\n    return variable;\n}\n\n/**\n * Takes any param and throws custom error if null or undefined.\n *\n * @param {any} variable\n * @returns {object}\n */\nexport function requireNonNull(variable) {\n    if (!isNonNull(variable)) {\n        throw new Error(REQUIRE_NON_NULL_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return variable;\n    }\n}\n\n/**\n * Takes any param and throws custom error if params are not same type.\n *\n * @param {any | null | undefined} variable\n * @param {any | null | undefined} type\n * @returns {object}\n */\nexport function requireType(variable, type) {\n    if (!isType(variable, type)) {\n        throw new Error(REQUIRE_TYPE_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return variable;\n    }\n}\n\n/**\n * Takes any param and throws custom error if non BigNumber.\n *\n * @param {any | null | undefined} variable\n * @returns {BigNumber}\n */\nexport function requireBigNumber(variable) {\n    if (!isBigNumber(requireNonNull(variable))) {\n        throw new Error(REQUIRE_BIGNUMBER_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {BigNumber} */ (variable);\n    }\n}\n\n/**\n * Takes any param and throws custom error if non BigNumber.\n *\n * @param {any | null | undefined} variable\n * @returns {Long}\n */\nexport function requireLong(variable) {\n    if (!isLong(requireNonNull(variable))) {\n        throw new Error(REQUIRE_LONG_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {Long} */ (variable);\n    }\n}\n\n/**\n * Takes any param and throws custom error if non string.\n *\n * @param {any | null | undefined} variable\n * @returns {string}\n */\nexport function requireString(variable) {\n    if (!isString(requireNonNull(variable))) {\n        throw new Error(REQUIRE_STRING_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {string} */ (variable);\n    }\n}\n\n/**\n * Takes any param and throws custom error if non Uint8Array.\n *\n * @param {any | null | undefined} variable\n * @returns {Uint8Array}\n */\nexport function requireUint8Array(variable) {\n    if (!isUint8Array(requireNonNull(variable))) {\n        throw new Error(REQUIRE_UINT8ARRAY_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {Uint8Array} */ (variable);\n    }\n}\n\n/**\n * Takes any param and throws custom error if non Uint8Array.\n *\n * @param {any | null | undefined} variable\n * @returns {number}\n */\nexport function requireNumber(variable) {\n    if (!isNumber(requireNonNull(variable))) {\n        throw new Error(REQUIRE_NUMBER_ERROR);\n    } else {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {number} */ (variable);\n    }\n}\n\n/**\n * Takes any param and throws custom error if null or undefined and not a string or Uint8Array.\n *\n * @param {any | null | undefined} variable\n * @returns {string | Uint8Array}\n */\nexport function requireStringOrUint8Array(variable) {\n    if (isStringOrUint8Array(requireNonNull(variable))) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return /** @type {string | Uint8Array} */ (variable);\n    } else {\n        throw new Error(REQUIRE_STRING_OR_UINT8ARRAY_ERROR);\n    }\n}\n\n//Conversions\n\n/**\n * Converts number or string to BigNumber.\n *\n * @param {any | null | undefined} variable\n * @returns {BigNumber}\n */\nexport function convertToBigNumber(variable) {\n    requireNonNull(variable);\n    if (\n        isBigNumber(variable) ||\n        isString(variable) ||\n        isNumber(variable) ||\n        isLong(variable)\n    ) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        return new BigNumber(variable);\n    }\n    throw new Error(FUNCTION_CONVERT_TO_BIGNUMBER_ERROR);\n}\n\n/**\n * Converts Array of Numbers or Strings to Array of BigNumbers.\n *\n * @param {any | null | undefined} variable\n * @returns {Array<BigNumber>}\n */\nexport function convertToBigNumberArray(variable) {\n    if (variable instanceof Array) {\n        return /** @type {Array<BigNumber>} */ (\n            variable.map(convertToBigNumber)\n        );\n    } else {\n        throw new Error(REQUIRE_ARRAY_ERROR);\n    }\n}\n\n/**\n * @param {*} variable\n * @returns {number}\n */\nexport function convertToNumber(variable) {\n    requireNonNull(variable);\n    if (\n        isBigNumber(variable) ||\n        isString(variable) ||\n        isNumber(variable) ||\n        isLong(variable)\n    ) {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        const num = parseInt(variable);\n        if (isNaN(num)) {\n            throw new Error(FUNCTION_CONVERT_TO_NUMBER_PARSE_ERROR);\n        } else {\n            return num;\n        }\n    } else {\n        throw new Error(FUNCTION_CONVERT_TO_NUMBER_ERROR);\n    }\n}\n\n/**\n * Creates a DataView on top of an Uint8Array that could be or not be pooled, ensuring that we don't get out of bounds.\n *\n * @param {Uint8Array | Int8Array} arr\n * @param {number | undefined} offset\n * @param {number | undefined} length\n * @returns {DataView}\n */\nexport function safeView(arr, offset = 0, length = arr.byteLength) {\n    if (!(Number.isInteger(offset) && offset >= 0))\n        throw new Error(\"Invalid offset!\");\n    if (!(Number.isInteger(length) && length >= 0))\n        throw new Error(\"Invalid length!\");\n    return new DataView(\n        arr.buffer,\n        arr.byteOffset + offset,\n        Math.min(length, arr.byteLength - offset),\n    );\n}\n\n/**\n * @param {any} a\n * @param {any} b\n * @param {Set<string>=} ignore\n * @returns {boolean}\n */\nexport function compare(a, b, ignore = new Set()) {\n    if (typeof a === \"object\" && typeof b === \"object\") {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        const aKeys = Object.keys(a);\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument\n        const bKeys = Object.keys(b);\n\n        if (aKeys.length !== bKeys.length) {\n            return false;\n        }\n\n        for (let i = 0; i < aKeys.length; i++) {\n            if (aKeys[i] !== bKeys[i]) {\n                return false;\n            }\n\n            if (ignore.has(aKeys[i])) {\n                continue;\n            }\n\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n            if (!compare(a[aKeys[i]], b[bKeys[i]], ignore)) {\n                return false;\n            }\n        }\n\n        return true;\n    } else if (typeof a === \"number\" && typeof b === \"number\") {\n        return a === b;\n    } else if (typeof a === \"string\" && typeof b === \"string\") {\n        return a === b;\n    } else if (typeof a === \"boolean\" && typeof b === \"boolean\") {\n        return a === b;\n    } else {\n        return false;\n    }\n}\n\n/**\n * https://stackoverflow.com/questions/2450954/how-to-randomize-shuffle-a-javascript-array\n *\n * @template T\n * @param {Array<T>} array\n */\nexport function shuffle(array) {\n    var currentIndex = array.length,\n        temporaryValue,\n        randomIndex;\n\n    // While there remain elements to shuffle...\n    while (0 !== currentIndex) {\n        // Pick a remaining element...\n        randomIndex = Math.floor(Math.random() * currentIndex);\n        currentIndex -= 1;\n\n        // And swap it with the current element.\n        temporaryValue = array[currentIndex];\n        array[currentIndex] = array[randomIndex];\n        array[randomIndex] = temporaryValue;\n    }\n}\n\n/**\n * @param {Uint8Array} array1\n * @param {Uint8Array} array2\n * @returns {boolean}\n */\nexport function arrayEqual(array1, array2) {\n    if (array1 === array2) {\n        return true;\n    }\n\n    if (array1.byteLength !== array2.byteLength) {\n        return false;\n    }\n\n    const view1 = new DataView(\n        array1.buffer,\n        array1.byteOffset,\n        array1.byteLength,\n    );\n    const view2 = new DataView(\n        array2.buffer,\n        array2.byteOffset,\n        array2.byteLength,\n    );\n\n    let i = array1.byteLength;\n\n    while (i--) {\n        if (view1.getUint8(i) !== view2.getUint8(i)) {\n            return false;\n        }\n    }\n\n    return true;\n}\n\n/**\n * @description Function that delays an execution for a given time (in milliseconds)\n * @param {number} ms\n * @returns {Promise<void>}\n */\nexport function wait(ms) {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Converts a SCREAMING_SNAKE_CASE string to PascalCase\n * @param {string} name - The string to convert\n * @returns {string} The converted PascalCase string\n */\nexport function screamingSnakeToPascalCase(name) {\n    const words = name.toLowerCase().split(\"_\");\n    let result = \"\";\n    for (let i = 0; i < words.length; i++) {\n        result += words[i].charAt(0).toUpperCase() + words[i].slice(1);\n    }\n    return result;\n}\n"],"names":["REQUIRE_NON_NULL_ERROR","REQUIRE_STRING_OR_UINT8ARRAY_ERROR","REQUIRE_ARRAY_ERROR","FUNCTION_CONVERT_TO_BIGNUMBER_ERROR","FUNCTION_CONVERT_TO_NUMBER_ERROR","FUNCTION_CONVERT_TO_NUMBER_PARSE_ERROR","isNonNull","variable","isUint8Array","Uint8Array","isNumber","Number","isBigNumber","BigNumber","isLong","Long","isString","isStringOrUint8Array","isLongZeroAddress","address","i","requireNotNegative","isNegative","Error","requireNonNull","requireStringOrUint8Array","convertToBigNumber","convertToBigNumberArray","Array","map","convertToNumber","num","parseInt","isNaN","safeView","arr","offset","length","byteLength","isInteger","DataView","buffer","byteOffset","Math","min","compare","a","b","ignore","Set","aKeys","Object","keys","bKeys","has","shuffle","array","temporaryValue","randomIndex","currentIndex","floor","random","arrayEqual","array1","array2","view1","view2","getUint8","wait","ms","Promise","resolve","setTimeout"],"mappings":"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"}

package/lib/version.cjs

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SDK_VERSION = exports.SDK_NAME = void 0;
+const SDK_NAME = exports.SDK_NAME = "hiero-sdk-js";
+const SDK_VERSION = exports.SDK_VERSION = typeof __SDK_VERSION__ !== "undefined" ? __SDK_VERSION__ : "DEV";

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export const SDK_NAME: "hiero-sdk-js";
+export const SDK_VERSION: string;

package/lib/version.js

@@ -0,0 +1,2 @@
+const o="hiero-sdk-js",s="2.70.0";export{o as SDK_NAME,s as SDK_VERSION};
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sources":["../src/version.js"],"sourcesContent":["export const SDK_NAME = \"hiero-sdk-js\";\nexport const SDK_VERSION =\n    typeof __SDK_VERSION__ !== \"undefined\" ? __SDK_VERSION__ : \"DEV\";\n"],"names":["SDK_NAME","SDK_VERSION"],"mappings":"AAAY,MAACA,EAAW,eACXC,EACgC"}

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@hiero-ledger/sdk",
+  "version": "2.70.0",
+  "description": "Hiero SDK",
+  "types": "./lib/index.d.ts",
+  "main": "./lib/index.cjs",
+  "module": "./src/index.js",
+  "react-native": {
+    "./lib/index.cjs": "./src/native.js",
+    "./src/encoding/hex.js": "./src/encoding/hex.native.js",
+    "./src/encoding/utf8.js": "./src/encoding/utf8.native.js",
+    "./src/cryptography/sha384.js": "./src/cryptography/sha384.native.js"
+  },
+  "browser": {
+    "./lib/index.js": "./lib/browser.js",
+    "./lib/network/AddressBookQuery.js": "./lib/network/AddressBookQueryWeb.js",
+    "./lib/encoding/hex.js": "./lib/encoding/hex.browser.js",
+    "./lib/encoding/utf8.js": "./lib/encoding/utf8.browser.js",
+    "./lib/cryptography/sha384.js": "./lib/cryptography/sha384.browser.js",
+    "crypto": false
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js",
+      "require": "./lib/index.cjs"
+    }
+  },
+  "license": "Apache-2.0",
+  "author": "Launchbadge <contact@launchbadge.com>",
+  "repository": "https://github.com/hiero-ledger/hiero-sdk-js",
+  "bugs": "https://github.com/hiero-ledger/hiero-sdk-js/issues",
+  "type": "module",
+  "keywords": [
+    "hiero",
+    "hedera",
+    "hashgraph",
+    "sdk",
+    "transactions"
+  ],
+  "sideEffects": true,
+  "files": [
+    "lib/",
+    "src/",
+    "dist/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "browserslist": [
+    "> 0.5%",
+    "last 2 versions",
+    "not dead",
+    "not op_mini all",
+    "not ie > 0"
+  ],
+  "dependencies": {
+    "@ethersproject/abi": "^5.8.0",
+    "@ethersproject/bignumber": "^5.8.0",
+    "@ethersproject/bytes": "^5.8.0",
+    "@ethersproject/rlp": "^5.8.0",
+    "@grpc/grpc-js": "^1.12.6",
+    "@hashgraph/cryptography": "1.9.0",
+    "@hashgraph/proto": "2.20.0",
+    "bignumber.js": "^9.1.1",
+    "bn.js": "^5.1.1",
+    "crypto-js": "^4.2.0",
+    "js-base64": "^3.7.4",
+    "long": "^5.3.1",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0",
+    "protobufjs": "7.2.5",
+    "rfc4648": "^1.5.3",
+    "utf8": "^3.0.0"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.23.4",
+    "@babel/core": "^7.23.3",
+    "@babel/eslint-parser": "^7.23.3",
+    "@babel/plugin-proposal-export-namespace-from": "^7.18.9",
+    "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+    "@babel/plugin-transform-export-namespace-from": "^7.22.3",
+    "@babel/plugin-transform-modules-commonjs": "^7.21.5",
+    "@babel/preset-env": "^7.22.15",
+    "@babel/register": "^7.22.5",
+    "@grpc/proto-loader": "^0.7.9",
+    "@playwright/test": "^1.30.0",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.3",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-replace": "^6.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/crypto-js": "^4.2.0",
+    "@types/node": "^24.0.8",
+    "@types/utf8": "^3.0.1",
+    "@typescript-eslint/eslint-plugin": "^5.48.2",
+    "@typescript-eslint/parser": "^5.62.0",
+    "@vitest/browser": "^3.1.1",
+    "@vitest/coverage-v8": "^3.1.2",
+    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "babel-plugin-module-rewrite": "^0.2.0",
+    "c8": "^10.1.3",
+    "chromedriver": "^138.0.0",
+    "codecov": "^3.8.3",
+    "dotenv": "^17.0.1",
+    "dpdm": "^3.11.0",
+    "eslint": "^8.52.0",
+    "eslint-plugin-compat": "^6.0.2",
+    "eslint-plugin-deprecation": "^3.0.0",
+    "eslint-plugin-ie11": "^1.0.0",
+    "eslint-plugin-import": "^2.28.1",
+    "eslint-plugin-jsdoc": "^52.0.2",
+    "eslint-plugin-n": "^17.16.1",
+    "eslint-plugin-vitest": "0.3.25",
+    "geckodriver": "^5.0.0",
+    "jsdom": "^26.0.0",
+    "msw": "^2.10.2",
+    "npm-run-all": "^4.1.5",
+    "npx": "^10.2.2",
+    "nyc": "^17.1.0",
+    "playwright": "^1.51.1",
+    "prettier": "^3.0.3",
+    "rollup": "^4.34.8",
+    "sinon": "^21.0.0",
+    "typedoc": "^0.28.1",
+    "typescript": "^5.7.2",
+    "vite": "^6.1.6",
+    "vitest": "^3.1.1",
+    "yalc": "1.0.0-pre.53"
+  },
+  "peerDependencies": {
+    "bn.js": "^5.2.1"
+  },
+  "resolutions": {
+    "bn.js": "5.2.1"
+  }
+}

package/src/BadEntityIdError.js

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: Apache-2.0
+
+export default class BadEntityIdError extends Error {
+    /**
+     * @param {Long} shard
+     * @param {Long} realm
+     * @param {Long} num
+     * @param {string} presentChecksum
+     * @param {string} expectedChecksum
+     */
+    constructor(shard, realm, num, presentChecksum, expectedChecksum) {
+        super(
+            `Entity ID ${shard.toString()}.${realm.toString()}.${num.toString()}-${presentChecksum} was incorrect.`,
+        );
+
+        this.name = "BadEntityIdException";
+
+        this.shard = shard;
+        this.realm = realm;
+        this.num = num;
+        this.presentChecksum = presentChecksum;
+        this.expectedChecksum = expectedChecksum;
+    }
+}