@hashgraphonline/standards-sdk 0.1.168 → 0.1.170

package/dist/es/standards-sdk.es126.js

@@ -1,605 +1,163 @@
-import { PrivateKey } from "@hashgraph/sdk";
-var KeyType = /* @__PURE__ */ ((KeyType2) => {
-  KeyType2["ED25519"] = "ed25519";
-  KeyType2["ECDSA"] = "ecdsa";
-  KeyType2["UNKNOWN"] = "unknown";
-  return KeyType2;
-})(KeyType || {});
-const _KeyTypeDetector = class _KeyTypeDetector {
-  /**
-   * Detects private key type from various input formats without throwing errors
-   *
-   * This detector is designed for private keys only. It uses various heuristics to determine
-   * the key type for ambiguous 32-byte keys, including byte patterns and statistical analysis.
-   *
-   * For ambiguous cases (where confidence is 'uncertain'), if you have the associated account ID,
-   * you can use the Hedera mirror node to confirm the key type.
-   *
-   * @param keyInput - The key to detect, can be a string (hex, base64, PEM), Buffer, or Uint8Array
-   * @returns KeyInfo object containing the detected key type and metadata
-   *
-   * @example
-   * // Detect from hex string
-   * const info1 = KeyTypeDetector.detect('0x7f96cea0c0d9d5bfb3ab8a42cf0cea44d57f62f2e068f8e5a3251914a9252b04');
-   *
-   * // Detect from DER-encoded string
-   * const info2 = KeyTypeDetector.detect(privateKey.toStringDer());
-   *
-   * // Detect from PEM format
-   * const info3 = KeyTypeDetector.detect(`-----BEGIN PRIVATE KEY-----
-   * MC4CAQAwBQYDK2VwBCIEIGRchBsQGQduAAGBQ7GAkKCKkmQ3EGCARwHsHiRqTNR9
-   * -----END PRIVATE KEY-----`);
-   */
-  static detect(keyInput) {
-    try {
-      let keyBytes;
-      let originalFormat = "raw";
-      if (typeof keyInput === "string") {
-        let trimmed = keyInput.trim();
-        if (trimmed.includes("-----BEGIN")) {
-          return this.detectFromPem(trimmed);
-        }
-        if (trimmed.toLowerCase().startsWith("0x")) {
-          trimmed = trimmed.substring(2);
-        }
-        if (this.isValidHex(trimmed)) {
-          keyBytes = this.hexToBytes(trimmed);
-          originalFormat = "hex";
-        } else if (this.isBase64(trimmed)) {
-          keyBytes = Buffer.from(trimmed, "base64");
-          originalFormat = "der";
-        } else {
-          return {
-            type: "unknown",
-            format: "raw",
-            isPrivateKey: false,
-            confidence: "certain"
-          };
-        }
-      } else if (keyInput instanceof Buffer) {
-        keyBytes = new Uint8Array(keyInput);
-      } else {
-        keyBytes = keyInput;
-      }
-      return this.detectFromBytes(keyBytes, originalFormat);
-    } catch (error) {
-      return {
-        type: "unknown",
-        format: "raw",
-        isPrivateKey: false,
-        confidence: "certain"
-      };
-    }
-  }
-  /**
-   * Detect key type from raw bytes
-   *
-   * @param bytes - The raw bytes of the key
-   * @param format - The original format of the key
-   * @returns KeyInfo object with detection results
-   * @private
-   */
-  static detectFromBytes(bytes, format) {
-    if (this.hasPrefix(bytes, this.ED25519_PUBLIC_KEY_PREFIX)) {
-      const keyStart = this.ED25519_PUBLIC_KEY_PREFIX.length;
-      return {
-        type: "ed25519",
-        format: "der",
-        isPrivateKey: false,
-        rawBytes: bytes.slice(keyStart),
-        confidence: "certain"
-      };
-    }
-    if (this.hasPrefix(bytes, this.ED25519_PRIVATE_KEY_PREFIX)) {
-      const keyStart = this.ED25519_PRIVATE_KEY_PREFIX.length;
-      if (bytes.length >= keyStart + 32) {
-        return {
-          type: "ed25519",
-          format: "der",
-          isPrivateKey: true,
-          rawBytes: bytes.slice(keyStart, keyStart + 32),
-          confidence: "certain"
-        };
-      }
-    }
-    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PUBLIC_KEY_PREFIX)) {
-      const keyStart = this.ECDSA_SECP256K1_PUBLIC_KEY_PREFIX.length;
-      return {
-        type: "ecdsa",
-        format: "der",
-        isPrivateKey: false,
-        rawBytes: bytes.slice(keyStart),
-        confidence: "certain"
-      };
-    }
-    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT)) {
-      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT.length;
-      return {
-        type: "ecdsa",
-        format: "der",
-        isPrivateKey: true,
-        rawBytes: bytes.slice(keyStart),
-        confidence: "certain"
-      };
-    }
-    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX)) {
-      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX.length;
-      return {
-        type: "ecdsa",
-        format: "der",
-        isPrivateKey: true,
-        rawBytes: bytes.slice(keyStart, keyStart + 32),
-        confidence: "certain"
-      };
-    }
-    if (this.hasPrefix(bytes, this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG)) {
-      const keyStart = this.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG.length;
-      return {
-        type: "ecdsa",
-        format: "der",
-        isPrivateKey: true,
-        rawBytes: bytes.slice(keyStart, keyStart + 32),
-        confidence: "certain"
-      };
-    }
-    if (bytes.length > 36 && this.containsECDSAPrivateKeyPattern(bytes)) {
-      return {
-        type: "ecdsa",
-        format: "der",
-        isPrivateKey: true,
-        rawBytes: this.extractECDSAPrivateKey(bytes),
-        confidence: "certain"
-      };
-    }
-    switch (bytes.length) {
-      case this.ED25519_PUBLIC_KEY_LENGTH:
-        if (format === "hex") {
-          const hexStr = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
-          const privateResult = this.tryCreateKey(hexStr);
-          if (privateResult.type !== "unknown") {
-            return privateResult;
-          }
-        }
-        return {
-          type: "unknown",
-          format,
-          isPrivateKey: false,
-          rawBytes: bytes,
-          confidence: "certain"
-        };
-      case this.ED25519_EXPANDED_PRIVATE_KEY_LENGTH:
-        return {
-          type: "ed25519",
-          format,
-          isPrivateKey: true,
-          rawBytes: bytes,
-          confidence: "certain"
-        };
-    }
-    return {
-      type: "unknown",
-      format,
-      isPrivateKey: false,
-      rawBytes: bytes,
-      confidence: "certain"
-    };
+import { Logger } from "./standards-sdk.es123.js";
+class ProgressReporter {
+  constructor(options = {}) {
+    this.module = options.module || "Progress";
+    this.callback = options.callback;
+    this.logger = options.logger || new Logger({
+      level: "info",
+      module: "ProgressReporter"
+    });
+    this.logProgress = options.logProgress ?? true;
+    this.minPercent = options.minPercent ?? 0;
+    this.maxPercent = options.maxPercent ?? 100;
+    this.lastReportedPercent = -1;
+    this.lastReportedTime = 0;
+    this.throttleMs = 100;
   }
-  /**
-   * Detect key type from PEM format
-   *
-   * @param pem - The PEM-encoded key string
-   * @returns KeyInfo object with detection results
-   * @private
-   */
-  static detectFromPem(pem) {
-    const trimmedPem = pem.trim();
-    const isPrivateKey = trimmedPem.includes("PRIVATE KEY");
-    const pemTypes = {
-      EC_PRIVATE: /-----BEGIN EC PRIVATE KEY-----/,
-      EC_PUBLIC: /-----BEGIN EC PUBLIC KEY-----/,
-      PRIVATE: /-----BEGIN PRIVATE KEY-----/,
-      PUBLIC: /-----BEGIN PUBLIC KEY-----/
-    };
-    let isECKey = false;
-    for (const [type, regex] of Object.entries(pemTypes)) {
-      if (regex.test(trimmedPem) && type.includes("EC")) {
-        isECKey = true;
-        break;
+  static getInstance(options = {}) {
+    if (!ProgressReporter.instance) {
+      ProgressReporter.instance = new ProgressReporter(options);
+    } else {
+      if (options.callback) {
+        ProgressReporter.instance.setCallback(options.callback);
       }
-    }
-    const base64Match = trimmedPem.match(
-      /-----BEGIN[\s\S]+?-----[\r\n]+([\s\S]+?)[\r\n]+-----END/
-    );
-    if (!base64Match) {
-      return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
-      };
-    }
-    const base64Content = base64Match[1].replace(/\s/g, "");
-    try {
-      const derBytes = Buffer.from(base64Content, "base64");
-      const result = this.detectFromBytes(new Uint8Array(derBytes), "der");
-      if (result.type === "unknown" && isECKey) {
-        return {
-          type: "ecdsa",
-          format: "pem",
-          isPrivateKey,
-          rawBytes: derBytes,
-          confidence: "certain"
-        };
+      if (options.module) {
+        ProgressReporter.instance.setModule(options.module);
       }
-      return {
-        ...result,
-        format: "pem"
-      };
-    } catch {
-      return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
-      };
-    }
-  }
-  /**
-   * Try to create a key using Hedera SDK to validate the type
-   *
-   * @param keyInput - The key input string or bytes
-   * @returns KeyInfo object with detection results
-   * @private
-   */
-  static tryCreateKey(keyInput) {
-    try {
-      if (typeof keyInput === "string") {
-        let keyStr = keyInput.trim();
-        if (keyStr.toLowerCase().startsWith("0x")) {
-          keyStr = keyStr.substring(2);
-        }
-        if (this.isValidHex(keyStr) && keyStr.length === 64) {
-          const keyBytes = this.hexToBytes(keyStr);
-          const signatureResult = this.detectBySignature(keyStr);
-          if (signatureResult.type !== "unknown") {
-            return {
-              type: signatureResult.type,
-              format: "hex",
-              isPrivateKey: true,
-              rawBytes: keyBytes,
-              confidence: signatureResult.confidence,
-              warning: signatureResult.warning
-            };
-          }
-          return {
-            type: "unknown",
-            format: "hex",
-            isPrivateKey: false,
-            rawBytes: keyBytes,
-            confidence: "certain"
-          };
-        }
+      if (options.logger) {
+        ProgressReporter.instance.setLogger(options.logger);
       }
-    } catch {
-    }
-    return {
-      type: "unknown",
-      format: "hex",
-      isPrivateKey: false,
-      rawBytes: new Uint8Array(),
-      confidence: "certain"
-    };
-  }
-  /**
-   * Detect key type by attempting to sign a message with both algorithms
-   *
-   * For ambiguous cases where both algorithms can use the key, this method
-   * uses heuristics to make a best-effort determination. For production use
-   * with ambiguous keys, consider using the Hedera mirror node to confirm
-   * the key type if you have the associated account ID.
-   *
-   * @param hexKey - The hex string representation of the key
-   * @returns Object containing type, confidence level, and optional warning
-   * @private
-   */
-  static detectBySignature(hexKey) {
-    const keyBigInt = BigInt("0x" + hexKey);
-    const secp256k1Order = BigInt(
-      "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141"
-    );
-    if (keyBigInt === 0n) {
-      return {
-        type: "ed25519",
-        confidence: "certain"
-      };
-    }
-    if (keyBigInt >= secp256k1Order) {
-      return {
-        type: "ed25519",
-        confidence: "certain"
-      };
-    }
-    let ed25519CanSign = false;
-    let ecdsaCanSign = false;
-    try {
-      const ed25519Key = PrivateKey.fromStringED25519(hexKey);
-      const testMessage = new Uint8Array([1, 2, 3, 4, 5]);
-      const signature = ed25519Key.sign(testMessage);
-      if (ed25519Key.publicKey.verify(testMessage, signature)) {
-        ed25519CanSign = true;
+      if (options.minPercent !== void 0) {
+        ProgressReporter.instance.setMinPercent(options.minPercent);
       }
-    } catch {
-    }
-    try {
-      const ecdsaKey = PrivateKey.fromStringECDSA(hexKey);
-      const testMessage = new Uint8Array([1, 2, 3, 4, 5]);
-      const signature = ecdsaKey.sign(testMessage);
-      if (ecdsaKey.publicKey.verify(testMessage, signature)) {
-        ecdsaCanSign = true;
+      if (options.maxPercent !== void 0) {
+        ProgressReporter.instance.setMaxPercent(options.maxPercent);
       }
-    } catch {
     }
-    if (ed25519CanSign && ecdsaCanSign) {
-      const keyBytes = this.hexToBytes(hexKey);
-      if (keyBytes[0] === 168 && keyBytes[1] === 1) {
-        return {
-          type: "ed25519",
-          confidence: "uncertain",
-          warning: "Detection based on byte pattern heuristic. Both ED25519 and ECDSA accept this key."
-        };
-      }
-      let highBytes = 0;
-      for (const byte of keyBytes) {
-        if (byte >= 128) highBytes++;
-      }
-      const highByteRatio = highBytes / keyBytes.length;
-      if (highByteRatio >= 0.4 && highByteRatio <= 0.6) {
-        return {
-          type: "ecdsa",
-          confidence: "uncertain",
-          warning: "Detection based on entropy heuristic. Both ED25519 and ECDSA accept this key."
-        };
-      }
-      return {
-        type: "ecdsa",
-        confidence: "uncertain",
-        warning: "Detection based on entropy heuristic. Both ED25519 and ECDSA accept this key. Defaulting to ECDSA."
-      };
-    }
-    if (ed25519CanSign && !ecdsaCanSign) {
-      return {
-        type: "ed25519",
-        confidence: "certain"
-      };
-    }
-    if (ecdsaCanSign && !ed25519CanSign) {
-      return {
-        type: "ecdsa",
-        confidence: "certain"
-      };
-    }
-    return {
-      type: "unknown",
-      confidence: "certain"
-    };
+    return ProgressReporter.instance;
   }
-  /**
-   * Check if a string is valid hexadecimal with even length
-   *
-   * @param str - The string to check
-   * @returns True if the string is valid hex with even length
-   * @private
-   */
-  static isValidHex(str) {
-    return /^[0-9a-fA-F]+$/.test(str) && str.length % 2 === 0;
+  setCallback(callback) {
+    this.callback = callback;
   }
-  /**
-   * Check if a string is valid base64
-   *
-   * @param str - The string to check
-   * @returns True if the string is valid base64
-   * @private
-   */
-  static isBase64(str) {
-    try {
-      return Buffer.from(str, "base64").toString("base64") === str;
-    } catch {
-      return false;
-    }
+  setModule(module) {
+    this.module = module;
   }
-  /**
-   * Convert a hex string to bytes
-   *
-   * @param hex - The hex string to convert
-   * @returns Uint8Array of bytes
-   * @private
-   */
-  static hexToBytes(hex) {
-    const bytes = new Uint8Array(hex.length / 2);
-    for (let i = 0; i < hex.length; i += 2) {
-      bytes[i / 2] = parseInt(hex.substr(i, 2), 16);
-    }
-    return bytes;
+  setLogger(logger) {
+    this.logger = logger;
   }
-  /**
-   * Check if bytes start with a specific prefix
-   *
-   * @param bytes - The bytes to check
-   * @param prefix - The prefix to look for
-   * @returns True if bytes start with the prefix
-   * @private
-   */
-  static hasPrefix(bytes, prefix) {
-    if (bytes.length < prefix.length) return false;
-    for (let i = 0; i < prefix.length; i++) {
-      if (bytes[i] !== prefix[i]) return false;
-    }
-    return true;
-  }
-  /**
-   * Check if bytes contain an ECDSA private key pattern
-   *
-   * @param bytes - The bytes to check
-   * @returns True if ECDSA private key pattern is found
-   * @private
-   */
-  static containsECDSAPrivateKeyPattern(bytes) {
-    for (let i = 0; i < bytes.length - 7; i++) {
-      if (bytes[i] === 48 && bytes[i + 1] === 116 && bytes[i + 2] === 2 && bytes[i + 3] === 1 && bytes[i + 4] === 1 && bytes[i + 5] === 4 && bytes[i + 6] === 32) {
-        return true;
-      }
-    }
-    return false;
+  setMinPercent(minPercent) {
+    this.minPercent = minPercent;
   }
-  /**
-   * Extract ECDSA private key from DER structure
-   *
-   * @param bytes - The DER encoded bytes
-   * @returns The extracted private key bytes
-   * @private
-   */
-  static extractECDSAPrivateKey(bytes) {
-    for (let i = 0; i < bytes.length - 32; i++) {
-      if (bytes[i] === 4 && bytes[i + 1] === 32) {
-        return bytes.slice(i + 2, i + 34);
-      }
-    }
-    return bytes;
+  setMaxPercent(maxPercent) {
+    this.maxPercent = maxPercent;
   }
-};
-_KeyTypeDetector.ED25519_PUBLIC_KEY_LENGTH = 32;
-_KeyTypeDetector.ED25519_EXPANDED_PRIVATE_KEY_LENGTH = 64;
-_KeyTypeDetector.ED25519_PUBLIC_KEY_PREFIX = Buffer.from([
-  48,
-  42,
-  48,
-  5,
-  6,
-  3,
-  43,
-  101,
-  112,
-  3,
-  33,
-  0
-]);
-_KeyTypeDetector.ED25519_PRIVATE_KEY_PREFIX = Buffer.from([
-  48,
-  46,
-  2,
-  1,
-  0,
-  48,
-  5,
-  6,
-  3,
-  43,
-  101,
-  112,
-  4,
-  34,
-  4,
-  32
-]);
-_KeyTypeDetector.ECDSA_SECP256K1_PUBLIC_KEY_PREFIX = Buffer.from([
-  48,
-  86,
-  48,
-  16,
-  6,
-  7,
-  42,
-  134,
-  72,
-  206,
-  61,
-  2,
-  1,
-  6,
-  5,
-  43,
-  129,
-  4,
-  0,
-  10,
-  3,
-  66,
-  0
-]);
-_KeyTypeDetector.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX = Buffer.from([
-  48,
-  116,
-  2,
-  1,
-  1,
-  4,
-  32
-]);
-_KeyTypeDetector.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_SHORT = Buffer.from([
-  48,
-  48,
-  2,
-  1,
-  0,
-  48,
-  7,
-  6,
-  5,
-  43,
-  129,
-  4,
-  0,
-  10,
-  4,
-  34,
-  4,
-  32
-]);
-_KeyTypeDetector.ECDSA_SECP256K1_PRIVATE_KEY_PREFIX_LONG = Buffer.from(
-  [48, 119, 2, 1, 1, 4, 32]
-);
-let KeyTypeDetector = _KeyTypeDetector;
-function detectKeyTypeFromString(privateKeyString) {
-  const keyInfo = KeyTypeDetector.detect(privateKeyString);
-  if (keyInfo.type !== "unknown") {
-    try {
-      const privateKey = keyInfo.type === "ecdsa" ? PrivateKey.fromStringECDSA(privateKeyString) : PrivateKey.fromStringED25519(privateKeyString);
-      const result = {
-        detectedType: keyInfo.type,
-        privateKey
-      };
-      if (keyInfo.confidence === "uncertain") {
-        result.warning = `Key type detection is uncertain. If you have the associated account ID, consider using the Hedera mirror node to confirm the key type.`;
+  createSubProgress(options) {
+    const subReporter = new ProgressReporter({
+      module: this.module,
+      logger: this.logger,
+      logProgress: this.logProgress,
+      minPercent: options.minPercent,
+      maxPercent: options.maxPercent
+    });
+    const logPrefix = options.logPrefix || "";
+    subReporter.setCallback((data) => {
+      const scaledPercent = this.scalePercent(
+        data.progressPercent,
+        options.minPercent,
+        options.maxPercent
+      );
+      let formattedMessage = data.message;
+      if (logPrefix && !formattedMessage.startsWith(logPrefix)) {
+        formattedMessage = `${logPrefix}: ${formattedMessage}`;
       }
-      return result;
-    } catch (error) {
-    }
+      this.report({
+        stage: data.stage,
+        message: formattedMessage,
+        progressPercent: scaledPercent,
+        details: data.details
+      });
+    });
+    return subReporter;
   }
-  try {
-    const privateKey = PrivateKey.fromStringECDSA(privateKeyString);
-    return {
-      detectedType: "ecdsa",
-      privateKey,
-      warning: `Using ECDSA as default. If you have the associated account ID, consider using the Hedera mirror node to confirm the key type.`
+  report(data) {
+    const rawPercent = data.progressPercent;
+    const percent = Math.max(0, Math.min(100, rawPercent));
+    const scaledPercent = this.scalePercent(percent, 0, 100);
+    const now = Date.now();
+    if (scaledPercent === this.lastReportedPercent && now - this.lastReportedTime < this.throttleMs && data.stage !== "completed" && data.stage !== "failed") {
+      return;
+    }
+    this.lastReportedPercent = scaledPercent;
+    this.lastReportedTime = now;
+    const progressData = {
+      ...data,
+      progressPercent: scaledPercent
     };
-  } catch (ecdsaError) {
-    try {
-      const privateKey = PrivateKey.fromStringED25519(privateKeyString);
-      return {
-        detectedType: "ed25519",
-        privateKey,
-        warning: `Using ED25519 as fallback. If you have the associated account ID, consider using the Hedera mirror node to confirm the key type.`
-      };
-    } catch (ed25519Error) {
-      throw new Error(
-        `Failed to parse private key as either ECDSA or ED25519: ${ecdsaError}`
+    if (this.logProgress) {
+      this.logger.debug(
+        `[${this.module}] [${data.stage.toUpperCase()}] ${data.message} (${scaledPercent.toFixed(1)}%)`,
+        data.details
       );
     }
+    if (this.callback) {
+      try {
+        this.callback(progressData);
+      } catch (err) {
+        this.logger.warn(`Error in progress callback: ${err}`);
+      }
+    }
+  }
+  scalePercent(percent, sourceMin, sourceMax) {
+    const range = this.maxPercent - this.minPercent;
+    const sourceRange = sourceMax - sourceMin;
+    const scaleFactor = range / sourceRange;
+    return this.minPercent + (percent - sourceMin) * scaleFactor;
+  }
+  preparing(message, percent, details) {
+    this.report({
+      stage: "preparing",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  submitting(message, percent, details) {
+    this.report({
+      stage: "submitting",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  confirming(message, percent, details) {
+    this.report({
+      stage: "confirming",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  verifying(message, percent, details) {
+    this.report({
+      stage: "verifying",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  completed(message, details) {
+    this.report({ stage: "completed", message, progressPercent: 100, details });
+  }
+  failed(message, details) {
+    this.report({
+      stage: "failed",
+      message,
+      progressPercent: this.lastReportedPercent,
+      details
+    });
   }
 }
 export {
-  KeyType,
-  KeyTypeDetector,
-  detectKeyTypeFromString
+  ProgressReporter
 };
 //# sourceMappingURL=standards-sdk.es126.js.map