@hashgraphonline/standards-sdk 0.1.184 → 0.1.185

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

@@ -1,629 +1,793 @@
-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 {
+import { proto } from "@hashgraph/proto";
+import { Buffer } from "buffer";
+import { Hbar, Long, HbarUnit, Transaction } from "@hashgraph/sdk";
+import { ethers } from "ethers";
+import { TransactionParsingError } from "./standards-sdk.es132.js";
+import { resolveTransactionSummary } from "./standards-sdk.es133.js";
+import { HTSParser } from "./standards-sdk.es141.js";
+import { HCSParser } from "./standards-sdk.es173.js";
+import { FileParser } from "./standards-sdk.es174.js";
+import { CryptoParser } from "./standards-sdk.es175.js";
+import { SCSParser } from "./standards-sdk.es176.js";
+import { UtilParser } from "./standards-sdk.es177.js";
+import { ScheduleParser } from "./standards-sdk.es142.js";
+import { transactionParserRegistry } from "./standards-sdk.es143.js";
+import { getTransactionTypeFromBody, getHumanReadableTransactionType } from "./standards-sdk.es144.js";
+class TransactionParser {
   /**
-   * Detects private key type from various input formats without throwing errors
+   * Parse transaction bytes in any supported format (base64 or hex, regular or scheduled)
+   * This is the main entry point for transaction parsing with enhanced retry logic
    *
-   * 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-----`);
+   * @param transactionBytes - Transaction bytes in base64 or hex format
+   * @param options - Parsing options and configuration
+   * @returns Promise resolving to ParsedTransaction
    */
-  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);
+  static async parseTransactionBytes(transactionBytes, options = {}) {
+    const {
+      enableFallback = true,
+      strictMode = false,
+      includeRaw = true,
+      maxRetries = 2
+    } = options;
+    const validation = this.validateTransactionBytes(transactionBytes);
+    if (!validation.isValid && strictMode) {
+      throw new TransactionParsingError(
+        `Invalid transaction bytes format: ${validation.error}`,
+        "INVALID_FORMAT",
+        void 0,
+        transactionBytes
+      );
+    }
+    let lastError;
+    let retryCount = 0;
+    while (retryCount <= maxRetries) {
+      try {
+        const result = await this.parseTransaction(transactionBytes, options);
+        result.formatDetection = {
+          originalFormat: validation.format || "base64",
+          wasConverted: validation.format === "hex",
+          length: transactionBytes.length
+        };
+        return result;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        retryCount++;
+        if (!enableFallback || retryCount > maxRetries) {
+          if (strictMode) {
+            throw new TransactionParsingError(
+              "Failed to parse transaction after all attempts",
+              "PARSING_FAILED",
+              lastError,
+              transactionBytes
+            );
+          }
+          break;
         }
-        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"
+        try {
+          const result = this.parseScheduledTransaction(
+            transactionBytes,
+            options
+          );
+          result.formatDetection = {
+            originalFormat: validation.format || "base64",
+            wasConverted: false,
+            length: transactionBytes.length
           };
+          return result;
+        } catch (scheduledError) {
         }
-      } 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"
-      };
     }
+    const fallbackResult = this.createFallbackResult(
+      transactionBytes,
+      lastError,
+      void 0
+    );
+    if (fallbackResult.details) {
+      fallbackResult.details.parseAttempts = Math.max(retryCount, 1);
+    }
+    return fallbackResult;
   }
   /**
-   * Detect key type from raw bytes
+   * Parse a Transaction object directly using unified delegation approach
+   * This method delegates to specialized parsers for clean separation of concerns
    *
-   * @param bytes - The raw bytes of the key
-   * @param format - The original format of the key
-   * @returns KeyInfo object with detection results
-   * @private
+   * @param transaction - The Transaction object to parse
+   * @param originalBytes - The original transaction bytes (optional, for protobuf parsing)
+   * @param options - Parsing options
+   * @returns Parsed transaction data
    */
-  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"
-      };
+  static parseTransactionObject(transaction, originalBytesOrOptions, options = {}) {
+    let originalBytes;
+    let actualOptions;
+    if (originalBytesOrOptions && !Buffer.isBuffer(originalBytesOrOptions) && !(originalBytesOrOptions instanceof Uint8Array)) {
+      actualOptions = originalBytesOrOptions;
+      originalBytes = void 0;
+    } else {
+      originalBytes = originalBytesOrOptions;
+      actualOptions = options;
     }
-    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"
-        };
+    try {
+      const metadata = this.extractTransactionMetadata(transaction);
+      const htsResult = HTSParser.parseFromTransactionObject(transaction);
+      const cryptoResult = CryptoParser.parseFromTransactionObject(transaction);
+      const hcsResult = HCSParser.parseFromTransactionObject(transaction);
+      const fileResult = FileParser.parseFromTransactionObject(transaction);
+      const scsResult = SCSParser.parseFromTransactionObject(transaction);
+      const scheduleResult = ScheduleParser.parseFromTransactionObject(transaction);
+      const utilResult = UtilParser.parseFromTransactionObject(transaction);
+      const results = [
+        htsResult,
+        cryptoResult,
+        hcsResult,
+        fileResult,
+        scsResult,
+        scheduleResult,
+        utilResult
+      ];
+      const primaryResult = results.find((result2) => result2.type && result2.type !== "UNKNOWN") || {};
+      let finalType = "UNKNOWN";
+      let finalHumanReadableType = "Unknown Transaction";
+      let parsedTokenCreation;
+      let protoParsingResult = {};
+      if (originalBytes || transaction.toBytes) {
+        try {
+          const bytesToParse = originalBytes || transaction.toBytes();
+          const decoded = proto.TransactionList.decode(bytesToParse);
+          if (decoded.transactionList && decoded.transactionList.length > 0) {
+            const tx = decoded.transactionList[0];
+            if (tx.bodyBytes && tx.bodyBytes.length > 0) {
+              const txBody = proto.TransactionBody.decode(tx.bodyBytes);
+              const typeResult = this.detectTransactionTypeFromBody(txBody);
+              finalType = typeResult.type;
+              finalHumanReadableType = typeResult.humanReadableType;
+              protoParsingResult = this.parseTransactionBodyDetails(
+                txBody,
+                finalType
+              );
+              if (protoParsingResult.tokenCreation) {
+                parsedTokenCreation = protoParsingResult.tokenCreation;
+              }
+            } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
+              const signedTx = proto.SignedTransaction.decode(
+                tx.signedTransactionBytes
+              );
+              if (signedTx.bodyBytes) {
+                const txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
+                const typeResult = this.detectTransactionTypeFromBody(txBody);
+                finalType = typeResult.type;
+                finalHumanReadableType = typeResult.humanReadableType;
+                protoParsingResult = this.parseTransactionBodyDetails(
+                  txBody,
+                  finalType
+                );
+                if (protoParsingResult.tokenCreation) {
+                  parsedTokenCreation = protoParsingResult.tokenCreation;
+                }
+              }
+            }
+          }
+        } catch (protoError) {
+        }
       }
-    }
-    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 (finalType === "UNKNOWN" && primaryResult.type) {
+        finalType = primaryResult.type;
+        finalHumanReadableType = primaryResult.humanReadableType || finalHumanReadableType;
+      }
+      const result = {
+        type: finalType,
+        humanReadableType: finalHumanReadableType,
+        transfers: [],
+        tokenTransfers: [],
+        ...metadata,
+        ...primaryResult,
+        raw: actualOptions.includeRaw ? transaction._transactionBody || {} : void 0
       };
-    }
-    if (bytes.length > 36 && this.containsECDSAPrivateKeyPattern(bytes)) {
+      this.mergeProtoParsingResults(
+        result,
+        protoParsingResult,
+        htsResult,
+        transaction,
+        originalBytes
+      );
+      result.transfers = cryptoResult.transfers || result.transfers || [];
+      result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
+      return result;
+    } catch (error) {
       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;
-          }
+        type: "UNKNOWN",
+        humanReadableType: "Unknown Transaction",
+        transfers: [],
+        tokenTransfers: [],
+        raw: actualOptions.includeRaw ? {} : void 0,
+        details: {
+          error: `Failed to parse Transaction object: ${error instanceof Error ? error.message : String(error)}`
         }
-        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"
-    };
   }
   /**
-   * Detect key type from PEM format
-   *
-   * @param pem - The PEM-encoded key string
-   * @returns KeyInfo object with detection results
-   * @private
+   * Parse a base64 encoded transaction body using registry pattern
+   * @param transactionBodyBase64 - The base64 encoded transaction body
+   * @returns The parsed transaction
    */
-  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 parseTransactionBody(transactionBodyBase64) {
+    try {
+      const buffer = ethers.decodeBase64(transactionBodyBase64);
+      const txBody = proto.SchedulableTransactionBody.decode(buffer);
+      const transactionType = this.getTransactionType(txBody);
+      const result = {
+        type: transactionType,
+        humanReadableType: this.getHumanReadableType(transactionType),
+        transfers: [],
+        tokenTransfers: [],
+        raw: txBody
+      };
+      if (txBody.memo) {
+        result.memo = txBody.memo;
       }
-    }
-    const beginMarkerIndex = trimmedPem.indexOf("-----BEGIN ");
-    if (beginMarkerIndex === -1) {
+      if (txBody.transactionFee) {
+        const hbarAmount = Hbar.fromTinybars(
+          Long.fromValue(txBody.transactionFee)
+        );
+        result.transactionFee = hbarAmount.toString(HbarUnit.Hbar);
+      }
+      this.applySchedulableTransactionParsing(txBody, result);
+      return result;
+    } catch (error) {
       return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
+        type: "UNKNOWN",
+        humanReadableType: "Unknown Transaction",
+        transfers: [],
+        tokenTransfers: [],
+        raw: void 0,
+        details: {
+          error: `Failed to parse transaction body: ${error instanceof Error ? error.message : String(error)}`
+        }
       };
     }
-    const beginLineEndIndex = trimmedPem.indexOf("\n", beginMarkerIndex);
-    if (beginLineEndIndex === -1) {
+  }
+  /**
+   * Detect transaction type and human-readable type from transaction body protobuf
+   * Uses registry pattern to eliminate massive if-else chain
+   */
+  static detectTransactionTypeFromBody(txBody) {
+    return getTransactionTypeFromBody(txBody);
+  }
+  /**
+   * Parse details from a complete schedule response
+   * @param scheduleResponse - The schedule response to parse
+   * @returns The parsed transaction
+   */
+  static parseScheduleResponse(scheduleResponse) {
+    if (!scheduleResponse.transaction_body) {
       return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
+        type: "UNKNOWN",
+        humanReadableType: "Unknown Transaction",
+        transfers: [],
+        tokenTransfers: [],
+        raw: void 0,
+        details: {
+          error: "Schedule response missing transaction_body"
+        }
       };
     }
-    const endMarkerIndex = trimmedPem.lastIndexOf("-----END ");
-    if (endMarkerIndex === -1 || endMarkerIndex <= beginLineEndIndex) {
-      return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
-      };
+    const parsed = this.parseTransactionBody(scheduleResponse.transaction_body);
+    if (scheduleResponse.memo) {
+      parsed.memo = scheduleResponse.memo;
     }
-    const base64Content = trimmedPem.slice(beginLineEndIndex + 1, endMarkerIndex).replace(/\s/g, "");
-    if (!base64Content) {
+    return parsed;
+  }
+  /**
+   * Determine the transaction type using registry pattern
+   * @param txBody - The transaction body to determine the type of
+   * @returns The type of the transaction
+   */
+  static getTransactionType(txBody) {
+    return getTransactionTypeFromBody(txBody).type;
+  }
+  /**
+   * Convert technical transaction type to human-readable format using registry pattern
+   * @param type - The technical transaction type
+   * @returns The human-readable transaction type
+   */
+  static getHumanReadableType(type) {
+    return getHumanReadableTransactionType(type);
+  }
+  /**
+   * Get a human-readable summary of the transaction
+   * @param parsedTx - The parsed transaction
+   * @returns The human-readable summary of the transaction
+   */
+  static getTransactionSummary(parsedTx) {
+    return resolveTransactionSummary(parsedTx);
+  }
+  /**
+   * Validate transaction bytes format and encoding
+   * Enhanced validation with better format detection
+   */
+  static validateTransactionBytes(transactionBytes) {
+    if (!transactionBytes || typeof transactionBytes !== "string") {
       return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
+        isValid: false,
+        error: "Transaction bytes must be a non-empty string"
       };
     }
-    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"
-        };
+    const format = this.detectTransactionFormat(transactionBytes);
+    const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+    const hexRegex = /^0x[0-9a-fA-F]+$/;
+    let isValid = false;
+    let error;
+    if (format === "hex") {
+      isValid = hexRegex.test(transactionBytes) && transactionBytes.length > 2;
+      if (!isValid) {
+        error = "Invalid hex format";
+      }
+    } else {
+      isValid = base64Regex.test(transactionBytes) && transactionBytes.length > 0;
+      if (!isValid) {
+        error = "Invalid base64 format";
       }
-      return {
-        ...result,
-        format: "pem"
-      };
-    } catch {
-      return {
-        type: "unknown",
-        format: "pem",
-        isPrivateKey,
-        confidence: "certain"
-      };
     }
+    return {
+      isValid,
+      format,
+      error,
+      length: transactionBytes.length
+    };
   }
   /**
-   * 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
+   * Detects the format of transaction bytes
+   * @param transactionBytes - The transaction bytes to analyze
+   * @returns The detected format ('base64' or 'hex')
+   */
+  static detectTransactionFormat(transactionBytes) {
+    return transactionBytes.startsWith("0x") ? "hex" : "base64";
+  }
+  /**
+   * Decodes transaction bytes from string to Uint8Array
+   * @param transactionBytes - The transaction bytes string (base64 or hex)
+   * @returns Decoded Uint8Array
+   * @throws TransactionParsingError if decoding fails
    */
-  static tryCreateKey(keyInput) {
+  static decodeTransactionBytes(transactionBytes) {
     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"
-          };
-        }
+      const format = this.detectTransactionFormat(transactionBytes);
+      if (format === "hex") {
+        const hexString = transactionBytes.slice(2);
+        return new Uint8Array(Buffer.from(hexString, "hex"));
+      } else {
+        return new Uint8Array(Buffer.from(transactionBytes, "base64"));
       }
-    } catch {
+    } catch (error) {
+      throw new TransactionParsingError(
+        "Failed to decode transaction bytes",
+        "DECODE_ERROR",
+        error instanceof Error ? error : void 0,
+        transactionBytes
+      );
     }
-    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
+   * Check if transaction bytes represent a valid Hedera transaction
    */
-  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;
+  static async isValidHederaTransaction(transactionBytes) {
     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 (!this.validateTransactionBytes(transactionBytes).isValid) {
+        return false;
       }
+      const bytes = this.decodeTransactionBytes(transactionBytes);
+      Transaction.fromBytes(bytes);
+      return true;
     } catch {
+      return false;
     }
+  }
+  /**
+   * Legacy alias for decodeTransactionBytes - keeping for backward compatibility
+   */
+  static decodeBytesLegacy(transactionBytes) {
+    return this.decodeTransactionBytes(transactionBytes);
+  }
+  /**
+   * Parse transaction bytes into structured data using thin orchestration
+   * Delegates to specialized parsers for clean separation of concerns
+   */
+  static async parseTransaction(transactionBytes, options = {}) {
     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;
-      }
-    } 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"
+      const bytes = this.decodeTransactionBytes(transactionBytes);
+      const transaction = Transaction.fromBytes(bytes);
+      const metadata = this.extractTransactionMetadataEnhanced(transaction);
+      const parserResults = this.runAllParsers(transaction);
+      const primaryResult = parserResults.find(
+        (result2) => result2.type && result2.type !== "UNKNOWN"
+      ) || {};
+      const protoParsingResult = this.parseFromProtobuf(bytes);
+      const finalType = protoParsingResult.type || primaryResult.type || "UNKNOWN";
+      const finalHumanReadableType = protoParsingResult.humanReadableType || primaryResult.humanReadableType || "Unknown Transaction";
+      const result = {
+        type: finalType,
+        humanReadableType: finalHumanReadableType,
+        transfers: [],
+        tokenTransfers: [],
+        details: { ...metadata },
+        memo: typeof metadata.memo === "string" ? metadata.memo : void 0,
+        transactionId: typeof metadata.transactionId === "string" ? metadata.transactionId : void 0,
+        nodeAccountIds: Array.isArray(metadata.nodeAccountIds) ? metadata.nodeAccountIds : [],
+        maxTransactionFee: typeof metadata.maxTransactionFee === "string" ? metadata.maxTransactionFee : void 0,
+        validStart: typeof metadata.validStart === "string" ? metadata.validStart : void 0,
+        validDuration: typeof metadata.validDuration === "string" ? metadata.validDuration : void 0,
+        raw: options.includeRaw ? {} : void 0
       };
+      this.mergeAllResults(
+        result,
+        protoParsingResult,
+        primaryResult,
+        parserResults
+      );
+      return result;
+    } catch (error) {
+      throw new TransactionParsingError(
+        "Failed to parse as regular transaction",
+        "REGULAR_PARSING_FAILED",
+        error instanceof Error ? error : void 0,
+        transactionBytes
+      );
     }
-    if (ecdsaCanSign && !ed25519CanSign) {
-      return {
-        type: "ecdsa",
-        confidence: "certain"
+  }
+  /**
+   * Parse scheduled transaction body
+   */
+  static parseScheduledTransaction(transactionBytes, options = {}) {
+    try {
+      const parsedTx = this.parseTransactionBody(transactionBytes);
+      const validation = this.validateTransactionBytes(transactionBytes);
+      const enhancedResult = {
+        ...parsedTx,
+        details: {
+          ...parsedTx.details || {},
+          parseMethod: "scheduled",
+          validation,
+          parseAttempts: parsedTx.details?.parseAttempts || 1
+        },
+        formatDetection: {
+          originalFormat: validation.format || "base64",
+          wasConverted: false,
+          length: transactionBytes.length
+        }
       };
+      return enhancedResult;
+    } catch (error) {
+      throw new TransactionParsingError(
+        "Failed to parse as scheduled transaction",
+        "SCHEDULED_PARSING_FAILED",
+        error instanceof Error ? error : void 0,
+        transactionBytes
+      );
     }
+  }
+  /**
+   * Extract metadata from Transaction object (legacy method - keeping for backward compatibility)
+   */
+  static extractTransactionMetadata(transaction) {
     return {
-      type: "unknown",
-      confidence: "certain"
+      transactionId: transaction.transactionId?.toString(),
+      nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
+      maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
+      memo: transaction._transactionMemo || void 0,
+      transfers: [],
+      tokenTransfers: []
     };
   }
   /**
-   * 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
+   * Extract enhanced metadata from Transaction object
    */
-  static isValidHex(str) {
-    return /^[0-9a-fA-F]+$/.test(str) && str.length % 2 === 0;
+  static extractTransactionMetadataEnhanced(transaction) {
+    return {
+      transactionId: transaction.transactionId?.toString(),
+      nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
+      maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
+      memo: transaction._transactionMemo || void 0,
+      validStart: transaction._transactionValidStart?.toString(),
+      validDuration: transaction._transactionValidDuration?.toString()
+    };
   }
   /**
-   * Check if a string is valid base64
-   *
-   * @param str - The string to check
-   * @returns True if the string is valid base64
-   * @private
+   * Run all available parsers on a transaction
+   */
+  static runAllParsers(transaction) {
+    return [
+      HTSParser.parseFromTransactionObject(transaction),
+      CryptoParser.parseFromTransactionObject(transaction),
+      HCSParser.parseFromTransactionObject(transaction),
+      FileParser.parseFromTransactionObject(transaction),
+      SCSParser.parseFromTransactionObject(transaction),
+      ScheduleParser.parseFromTransactionObject(transaction),
+      UtilParser.parseFromTransactionObject(transaction)
+    ];
+  }
+  /**
+   * Parse transaction from protobuf bytes
    */
-  static isBase64(str) {
+  static parseFromProtobuf(bytes) {
+    const result = {};
     try {
-      return Buffer.from(str, "base64").toString("base64") === str;
-    } catch {
-      return false;
+      const decoded = proto.TransactionList.decode(bytes);
+      if (decoded.transactionList && decoded.transactionList.length > 0) {
+        const tx = decoded.transactionList[0];
+        let txBody = null;
+        if (tx.bodyBytes && tx.bodyBytes.length > 0) {
+          txBody = proto.TransactionBody.decode(tx.bodyBytes);
+        } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
+          const signedTx = proto.SignedTransaction.decode(
+            tx.signedTransactionBytes
+          );
+          if (signedTx.bodyBytes) {
+            txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
+          }
+        }
+        if (txBody) {
+          const typeResult = this.detectTransactionTypeFromBody(txBody);
+          result.type = typeResult.type;
+          result.humanReadableType = typeResult.humanReadableType;
+          const details = this.parseTransactionBodyDetails(
+            txBody,
+            typeResult.type
+          );
+          Object.assign(result, details);
+        }
+      }
+    } catch (error) {
     }
+    return result;
   }
   /**
-   * Convert a hex string to bytes
-   *
-   * @param hex - The hex string to convert
-   * @returns Uint8Array of bytes
-   * @private
+   * Intelligently merge all parsing results
    */
-  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;
+  static mergeAllResults(result, protoResult, primaryResult, parserResults) {
+    const cryptoResult = parserResults.find((r) => r.transfers || r.tokenTransfers) || {};
+    result.transfers = cryptoResult.transfers || result.transfers || [];
+    result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
+    Object.keys(protoResult).forEach((key) => {
+      if (protoResult[key] !== void 0 && key !== "type" && key !== "humanReadableType") {
+        result[key] = protoResult[key];
+      }
+    });
+    Object.keys(primaryResult).forEach((key) => {
+      if (primaryResult[key] !== void 0 && !(key in result) && key !== "type" && key !== "humanReadableType") {
+        result[key] = primaryResult[key];
+      }
+    });
   }
   /**
-   * 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
+   * Apply schedulable transaction parsing using registry pattern
+   * Eliminates conditional logic in parseTransactionBody
    */
-  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;
+  static applySchedulableTransactionParsing(txBody, result) {
+    if (txBody.cryptoTransfer) {
+      CryptoParser.parseCryptoTransfers(txBody.cryptoTransfer, result);
+    }
+    if (txBody.cryptoDelete) {
+      result.cryptoDelete = CryptoParser.parseCryptoDelete(txBody.cryptoDelete);
+    }
+    if (txBody.cryptoCreateAccount) {
+      result.cryptoCreateAccount = CryptoParser.parseCryptoCreateAccount(
+        txBody.cryptoCreateAccount
+      );
+    }
+    if (txBody.cryptoUpdateAccount) {
+      result.cryptoUpdateAccount = CryptoParser.parseCryptoUpdateAccount(
+        txBody.cryptoUpdateAccount
+      );
+    }
+    if (txBody.cryptoApproveAllowance) {
+      result.cryptoApproveAllowance = CryptoParser.parseCryptoApproveAllowance(
+        txBody.cryptoApproveAllowance
+      );
+    }
+    if (txBody.cryptoDeleteAllowance) {
+      result.cryptoDeleteAllowance = CryptoParser.parseCryptoDeleteAllowance(
+        txBody.cryptoDeleteAllowance
+      );
+    }
+    if (txBody.contractCall) {
+      result.contractCall = SCSParser.parseContractCall(txBody.contractCall);
+    }
+    if (txBody.contractCreateInstance) {
+      result.contractCreate = SCSParser.parseContractCreate(
+        txBody.contractCreateInstance
+      );
+    }
+    if (txBody.contractUpdateInstance) {
+      result.contractUpdate = SCSParser.parseContractUpdate(
+        txBody.contractUpdateInstance
+      );
+    }
+    if (txBody.contractDeleteInstance) {
+      result.contractDelete = SCSParser.parseContractDelete(
+        txBody.contractDeleteInstance
+      );
+    }
+    if (txBody.tokenCreation) {
+      result.tokenCreation = HTSParser.parseTokenCreate(txBody.tokenCreation);
+    }
+    if (txBody.tokenMint) {
+      result.tokenMint = HTSParser.parseTokenMint(txBody.tokenMint);
+    }
+    if (txBody.tokenBurn) {
+      result.tokenBurn = HTSParser.parseTokenBurn(txBody.tokenBurn);
+    }
+    if (txBody.tokenUpdate) {
+      result.tokenUpdate = HTSParser.parseTokenUpdate(txBody.tokenUpdate);
+    }
+    if (txBody.tokenFeeScheduleUpdate) {
+      result.tokenFeeScheduleUpdate = HTSParser.parseTokenFeeScheduleUpdate(
+        txBody.tokenFeeScheduleUpdate
+      );
+    }
+    if (txBody.tokenFreeze) {
+      result.tokenFreeze = HTSParser.parseTokenFreeze(txBody.tokenFreeze);
+    }
+    if (txBody.tokenUnfreeze) {
+      result.tokenUnfreeze = HTSParser.parseTokenUnfreeze(txBody.tokenUnfreeze);
+    }
+    if (txBody.tokenGrantKyc) {
+      result.tokenGrantKyc = HTSParser.parseTokenGrantKyc(txBody.tokenGrantKyc);
+    }
+    if (txBody.tokenRevokeKyc) {
+      result.tokenRevokeKyc = HTSParser.parseTokenRevokeKyc(
+        txBody.tokenRevokeKyc
+      );
+    }
+    if (txBody.tokenPause) {
+      result.tokenPause = HTSParser.parseTokenPause(txBody.tokenPause);
+    }
+    if (txBody.tokenUnpause) {
+      result.tokenUnpause = HTSParser.parseTokenUnpause(txBody.tokenUnpause);
+    }
+    if (txBody.tokenWipe) {
+      result.tokenWipeAccount = HTSParser.parseTokenWipeAccount(
+        txBody.tokenWipe
+      );
+    }
+    if (txBody.tokenDeletion) {
+      result.tokenDelete = HTSParser.parseTokenDelete(txBody.tokenDeletion);
+    }
+    if (txBody.tokenAssociate) {
+      result.tokenAssociate = HTSParser.parseTokenAssociate(
+        txBody.tokenAssociate
+      );
+    }
+    if (txBody.tokenDissociate) {
+      result.tokenDissociate = HTSParser.parseTokenDissociate(
+        txBody.tokenDissociate
+      );
+    }
+    if (txBody.tokenAirdrop) {
+      result.tokenAirdrop = HTSParser.parseTokenAirdropFromProto(
+        txBody.tokenAirdrop
+      );
+    }
+    if (txBody.consensusCreateTopic) {
+      result.consensusCreateTopic = HCSParser.parseConsensusCreateTopic(
+        txBody.consensusCreateTopic
+      );
+    }
+    if (txBody.consensusSubmitMessage) {
+      result.consensusSubmitMessage = HCSParser.parseConsensusSubmitMessage(
+        txBody.consensusSubmitMessage
+      );
+    }
+    if (txBody.consensusUpdateTopic) {
+      result.consensusUpdateTopic = HCSParser.parseConsensusUpdateTopic(
+        txBody.consensusUpdateTopic
+      );
+    }
+    if (txBody.consensusDeleteTopic) {
+      result.consensusDeleteTopic = HCSParser.parseConsensusDeleteTopic(
+        txBody.consensusDeleteTopic
+      );
+    }
+    if (txBody.fileCreate) {
+      result.fileCreate = FileParser.parseFileCreate(txBody.fileCreate);
+    }
+    if (txBody.fileAppend) {
+      result.fileAppend = FileParser.parseFileAppend(txBody.fileAppend);
+    }
+    if (txBody.fileUpdate) {
+      result.fileUpdate = FileParser.parseFileUpdate(txBody.fileUpdate);
+    }
+    if (txBody.fileDelete) {
+      result.fileDelete = FileParser.parseFileDelete(txBody.fileDelete);
+    }
+    if (txBody.utilPrng) {
+      result.utilPrng = UtilParser.parseUtilPrng(txBody.utilPrng);
     }
-    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
+   * Parse transaction body details for all supported transaction types
+   * Uses a scalable registry pattern instead of if-else chains
    */
-  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;
+  static parseTransactionBodyDetails(txBody, transactionType) {
+    const result = {};
+    const parserConfig = transactionParserRegistry[transactionType];
+    if (parserConfig) {
+      const bodyData = txBody[parserConfig.bodyField];
+      if (bodyData) {
+        const parserResult = parserConfig.parser(bodyData);
+        if (parserConfig.spreadResult) {
+          Object.assign(result, parserResult);
+        } else {
+          result[parserConfig.resultField] = parserResult;
+        }
       }
     }
-    return false;
+    return result;
   }
   /**
-   * Extract ECDSA private key from DER structure
-   *
-   * @param bytes - The DER encoded bytes
-   * @returns The extracted private key bytes
-   * @private
+   * Merge protobuf parsing results with parser results using registry pattern
+   * Eliminates transactionFields array and forEach logic
    */
-  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);
+  static mergeProtoParsingResults(result, protoResult, htsResult, transaction, originalBytes) {
+    const fieldsToMerge = Object.values(transactionParserRegistry).map(
+      (config) => config.resultField
+    );
+    for (const field of fieldsToMerge) {
+      const protoValue = protoResult[field];
+      const htsValue = htsResult[field];
+      if (protoValue !== void 0) {
+        result[field] = protoValue;
+      } else if (htsValue !== void 0) {
+        result[field] = htsValue;
+      } else {
+        this.handleSpecialFieldExtraction(result, field, transaction);
       }
     }
-    return bytes;
   }
-};
-_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.`;
+  /**
+   * Handle special field extraction cases using registry pattern
+   */
+  static handleSpecialFieldExtraction(result, field, transaction) {
+    if (field === "tokenCreation" && result.type === "TOKENCREATE") {
+      const extracted = HTSParser.extractTokenCreationFromTransaction(transaction);
+      if (extracted) {
+        result[field] = extracted;
+      }
+    } else if (field === "tokenAirdrop" && result.type === "TOKENAIRDROP") {
+      const extracted = HTSParser.extractTokenAirdropFromTransaction(transaction);
+      if (extracted) {
+        result[field] = extracted;
       }
-      return result;
-    } catch (error) {
     }
   }
-  try {
-    const privateKey = PrivateKey.fromStringECDSA(privateKeyString);
+  /**
+   * Create fallback result when all parsing methods fail
+   */
+  static createFallbackResult(transactionBytes, primaryError, secondaryError) {
+    const validation = this.validateTransactionBytes(transactionBytes);
     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.`
+      type: "UNKNOWN",
+      humanReadableType: "Unknown Transaction",
+      transfers: [],
+      tokenTransfers: [],
+      details: {
+        rawBytes: transactionBytes.length > 100 ? transactionBytes.substring(0, 100) + "..." : transactionBytes,
+        primaryError: primaryError?.message,
+        secondaryError: secondaryError?.message,
+        parseAttempts: secondaryError ? 2 : 1,
+        validation
+      },
+      formatDetection: {
+        originalFormat: validation.format || "base64",
+        wasConverted: false,
+        length: transactionBytes.length
+      },
+      raw: {}
     };
-  } 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}`
-      );
-    }
   }
 }
 export {
-  KeyType,
-  KeyTypeDetector,
-  detectKeyTypeFromString
+  TransactionParser,
+  TransactionParsingError
 };
 //# sourceMappingURL=standards-sdk.es131.js.map