@hashgraphonline/standards-sdk 0.1.188 → 0.1.190

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

@@ -1,386 +1,793 @@
-import { z } from "zod";
-import { RegistryBrokerParseError } from "./standards-sdk.es151.js";
-const agentNetworkProviderSchema = z.enum([
-  "openclaw",
-  "dot",
-  "grok",
-  "muse",
-  "generic"
-]);
-const agentConnectionStateSchema = z.enum([
-  "unavailable",
-  "pending_pairing",
-  "interactive_verified",
-  "receive_unverified",
-  "receive_verified",
-  "paused",
-  "revoked",
-  "needs_reconnect"
-]);
-const agentRegistrationStateSchema = z.enum([
-  "unregistered",
-  "pending",
-  "registered",
-  "linked",
-  "failed"
-]);
-const agentReceiveModeSchema = z.enum(["none", "poll", "push", "events"]);
-const agentRequestStateSchema = z.enum([
-  "accepted",
-  "awaiting_consent",
-  "queued",
-  "processing",
-  "completed",
-  "rejected",
-  "failed",
-  "expired",
-  "canceled"
-]);
-const agentDeliveryStateSchema = z.enum([
-  "pending",
-  "notifying",
-  "provider_accepted",
-  "acknowledged",
-  "retry_scheduled",
-  "permanently_failed"
-]);
-const agentMessageKindSchema = z.enum(["request", "response", "event"]);
-const isoDate = z.string();
-const agentRuntimeViewSchema = z.object({
-  runtimeId: z.string().uuid(),
-  uaid: z.string().nullable(),
-  ownerType: z.string(),
-  ownerId: z.string(),
-  declaredProvider: agentNetworkProviderSchema,
-  connectionState: agentConnectionStateSchema,
-  registrationState: agentRegistrationStateSchema,
-  registrationAttemptId: z.string().nullable(),
-  receiveMode: agentReceiveModeSchema,
-  gatewayUrl: z.string().nullable(),
-  paused: z.boolean(),
-  allowedPeerUaids: z.array(z.string()).nullable(),
-  capabilities: z.array(z.string()),
-  lastActivityAt: isoDate.nullable(),
-  createdAt: isoDate
-});
-const agentRuntimeQuoteSchema = z.object({
-  quoteId: z.string(),
-  expiresAt: isoDate,
-  registrationFeeCredits: z.number().nullable(),
-  gatewayUrl: z.string()
-});
-const agentPairingStartSchema = z.object({
-  grantId: z.string().uuid(),
-  pairingCode: z.string(),
-  expiresAt: isoDate
-});
-const agentPairingCompleteSchema = z.object({
-  grantId: z.string().uuid(),
-  runtimeId: z.string().uuid(),
-  token: z.string(),
-  scopes: z.array(z.string())
-});
-const agentMessageViewSchema = z.object({
-  messageId: z.string().uuid(),
-  conversationId: z.string().uuid(),
-  schemaVersion: z.number().optional(),
-  kind: agentMessageKindSchema,
-  senderUaid: z.string(),
-  recipientUaid: z.string(),
-  inReplyTo: z.string().uuid().nullable(),
-  content: z.object({ type: z.literal("text"), text: z.string() }),
-  requestState: agentRequestStateSchema,
-  createdAt: isoDate,
-  expiresAt: isoDate,
-  traceId: z.string()
-});
-const agentMessageAcceptedSchema = z.object({
-  messageId: z.string().uuid(),
-  conversationId: z.string().uuid(),
-  requestState: agentRequestStateSchema,
-  createdAt: isoDate,
-  expiresAt: isoDate,
-  deduplicated: z.boolean()
-});
-const agentLeaseViewSchema = z.object({
-  leaseId: z.string().uuid(),
-  messageId: z.string().uuid(),
-  fencingToken: z.number().int(),
-  expiresAt: isoDate
-});
-const agentClaimedMessageSchema = z.object({
-  message: agentMessageViewSchema,
-  lease: agentLeaseViewSchema
-});
-const agentInboxItemSchema = z.object({
-  messageId: z.string().uuid(),
-  conversationId: z.string().uuid(),
-  kind: agentMessageKindSchema,
-  senderUaid: z.string(),
-  content: z.object({ type: z.literal("text"), text: z.string() }),
-  requestState: agentRequestStateSchema,
-  deliveryState: agentDeliveryStateSchema,
-  acknowledged: z.boolean(),
-  leaseId: z.string().uuid().nullable(),
-  fencingToken: z.number().int().nullable(),
-  createdAt: isoDate,
-  expiresAt: isoDate
-});
-const agentInboxListSchema = z.object({
-  items: z.array(agentInboxItemSchema),
-  nextCursor: z.string().nullable()
-});
-const agentConversationViewSchema = z.object({
-  conversationId: z.string().uuid(),
-  state: z.enum(["active", "canceled", "expired"]),
-  participants: z.array(z.object({ uaid: z.string() })),
-  messages: z.array(agentMessageViewSchema),
-  nextCursor: z.string().nullable()
-});
-const agentReplyResultSchema = z.object({
-  request: agentMessageViewSchema,
-  response: agentMessageViewSchema
-});
-const agentRuntimeRegistrationResultSchema = z.object({
-  runtime: agentRuntimeViewSchema,
-  registration: agentRegistrationStateSchema
-});
-const agentProbeResultSchema = z.object({
-  nonce: z.string(),
-  issuedAt: isoDate
-});
-const sleep = (ms, signal) => new Promise((resolve, reject) => {
-  const t = setTimeout(resolve, ms);
-  signal?.addEventListener(
-    "abort",
-    () => {
-      clearTimeout(t);
-      reject(new Error("waitForReply aborted"));
-    },
-    { once: true }
-  );
-});
-const bearerHeaders = (token) => ({
-  authorization: `Bearer ${token}`
-});
-const encodePath = (value) => encodeURIComponent(value);
-const qs = (params) => {
-  const query = new URLSearchParams();
-  for (const [k, v] of Object.entries(params)) {
-    if (v !== void 0) query.set(k, String(v));
-  }
-  const s = query.toString();
-  return s ? `?${s}` : "";
-};
-function createAgentNetworkApi(client) {
-  const json = async (path, schema, init) => {
-    const raw = await client.requestJson(`${path}`, {
-      method: init.method ?? "GET",
-      body: init.body,
-      headers: init.token ? bearerHeaders(init.token) : void 0
-    });
-    const parsed = schema.safeParse(raw);
-    if (!parsed.success) {
-      throw new RegistryBrokerParseError(
-        "Unexpected agent-network response shape",
-        JSON.stringify(raw).slice(0, 500)
+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.es153.js";
+import { resolveTransactionSummary } from "./standards-sdk.es154.js";
+import { HTSParser } from "./standards-sdk.es162.js";
+import { HCSParser } from "./standards-sdk.es212.js";
+import { FileParser } from "./standards-sdk.es213.js";
+import { CryptoParser } from "./standards-sdk.es214.js";
+import { SCSParser } from "./standards-sdk.es215.js";
+import { UtilParser } from "./standards-sdk.es216.js";
+import { ScheduleParser } from "./standards-sdk.es163.js";
+import { transactionParserRegistry } from "./standards-sdk.es164.js";
+import { getTransactionTypeFromBody, getHumanReadableTransactionType } from "./standards-sdk.es165.js";
+class TransactionParser {
+  /**
+   * 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
+   *
+   * @param transactionBytes - Transaction bytes in base64 or hex format
+   * @param options - Parsing options and configuration
+   * @returns Promise resolving to ParsedTransaction
+   */
+  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
       );
     }
-    return parsed.data;
-  };
-  const bot204 = async (path, token, body) => {
-    const response = await client.request(`${path}`, {
-      method: "POST",
-      body,
-      headers: bearerHeaders(token)
-    });
-    return response.status === 204 ? null : response.json();
-  };
-  return {
-    quoteRuntime: () => json("/agent-runtimes/quote", agentRuntimeQuoteSchema, {
-      method: "POST"
-    }),
-    registerRuntime: (input) => json("/agent-runtimes/register", agentRuntimeRegistrationResultSchema, {
-      method: "POST",
-      body: input
-    }),
-    listRuntimes: async () => {
-      const raw = await client.requestJson("/agent-runtimes", {});
-      const parsed = z.object({ runtimes: z.array(agentRuntimeViewSchema) }).safeParse(raw);
-      if (!parsed.success) {
-        throw new RegistryBrokerParseError(
-          "Unexpected runtime list shape",
-          JSON.stringify(raw).slice(0, 500)
-        );
+    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;
+        }
+        try {
+          const result = this.parseScheduledTransaction(
+            transactionBytes,
+            options
+          );
+          result.formatDetection = {
+            originalFormat: validation.format || "base64",
+            wasConverted: false,
+            length: transactionBytes.length
+          };
+          return result;
+        } catch (scheduledError) {
+        }
       }
-      return parsed.data.runtimes;
-    },
-    updateRuntimePolicy: (runtimeId, input) => json(
-      `/agent-runtimes/${encodePath(runtimeId)}`,
-      agentRuntimeViewSchema,
-      { method: "PATCH", body: input }
-    ),
-    probeRuntime: async (runtimeId) => await json(
-      `/agent-runtimes/${encodePath(runtimeId)}/probe`,
-      agentProbeResultSchema,
-      { method: "POST" }
-    ),
-    startAgentConnection: (runtimeId) => json("/agent-connections", agentPairingStartSchema, {
-      method: "POST",
-      body: { runtimeId }
-    }),
-    completeAgentPairing: (pairingCode) => json("/agent-connections/pair", agentPairingCompleteSchema, {
-      method: "POST",
-      body: { pairingCode }
-    }),
-    revokeAgentConnection: async (grantId) => {
-      await client.request(`/agent-connections/${encodePath(grantId)}`, {
-        method: "DELETE"
-      });
-    },
-    agentMe: async (token) => {
-      const raw = await client.requestJson(
-        "/agent-runtimes/me",
-        { headers: bearerHeaders(token) }
+    }
+    const fallbackResult = this.createFallbackResult(
+      transactionBytes,
+      lastError,
+      void 0
+    );
+    if (fallbackResult.details) {
+      fallbackResult.details.parseAttempts = Math.max(retryCount, 1);
+    }
+    return fallbackResult;
+  }
+  /**
+   * Parse a Transaction object directly using unified delegation approach
+   * This method delegates to specialized parsers for clean separation of concerns
+   *
+   * @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 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;
+    }
+    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 (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
+      };
+      this.mergeProtoParsingResults(
+        result,
+        protoParsingResult,
+        htsResult,
+        transaction,
+        originalBytes
       );
-      const parsed = z.object({ runtime: agentRuntimeViewSchema }).safeParse(raw);
-      if (!parsed.success) {
-        throw new RegistryBrokerParseError(
-          "Unexpected agent-runtimes/me shape",
-          JSON.stringify(raw).slice(0, 500)
+      result.transfers = cryptoResult.transfers || result.transfers || [];
+      result.tokenTransfers = cryptoResult.tokenTransfers || result.tokenTransfers || [];
+      return result;
+    } catch (error) {
+      return {
+        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)}`
+        }
+      };
+    }
+  }
+  /**
+   * Parse a base64 encoded transaction body using registry pattern
+   * @param transactionBodyBase64 - The base64 encoded transaction body
+   * @returns The parsed transaction
+   */
+  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;
+      }
+      if (txBody.transactionFee) {
+        const hbarAmount = Hbar.fromTinybars(
+          Long.fromValue(txBody.transactionFee)
         );
+        result.transactionFee = hbarAmount.toString(HbarUnit.Hbar);
       }
-      return parsed.data.runtime;
-    },
-    sendAgentMessage: (token, input) => json("/agent-messages", agentMessageAcceptedSchema, {
-      method: "POST",
-      body: input,
-      token
-    }),
-    getAgentMessage: (token, messageId) => json(
-      `/agent-messages/${encodePath(messageId)}`,
-      agentMessageViewSchema,
-      { token }
-    ),
-    getAgentConversation: (token, conversationId, query) => json(
-      `/agent-conversations/${encodePath(conversationId)}${qs({
-        cursor: query?.cursor,
-        limit: query?.limit
-      })}`,
-      agentConversationViewSchema,
-      { token }
-    ),
-    listAgentInbox: (token, query) => json(
-      `/agent-inbox${qs({
-        cursor: query?.cursor,
-        limit: query?.limit,
-        includeAcknowledged: query?.includeAcknowledged
-      })}`,
-      agentInboxListSchema,
-      { token }
-    ),
-    claimAgentMessage: async (token) => {
-      const raw = await bot204("/agent-inbox/leases", token, {});
-      if (raw === null) {
-        return null;
+      this.applySchedulableTransactionParsing(txBody, result);
+      return result;
+    } catch (error) {
+      return {
+        type: "UNKNOWN",
+        humanReadableType: "Unknown Transaction",
+        transfers: [],
+        tokenTransfers: [],
+        raw: void 0,
+        details: {
+          error: `Failed to parse transaction body: ${error instanceof Error ? error.message : String(error)}`
+        }
+      };
+    }
+  }
+  /**
+   * 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",
+        humanReadableType: "Unknown Transaction",
+        transfers: [],
+        tokenTransfers: [],
+        raw: void 0,
+        details: {
+          error: "Schedule response missing transaction_body"
+        }
+      };
+    }
+    const parsed = this.parseTransactionBody(scheduleResponse.transaction_body);
+    if (scheduleResponse.memo) {
+      parsed.memo = scheduleResponse.memo;
+    }
+    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 {
+        isValid: false,
+        error: "Transaction bytes must be a non-empty string"
+      };
+    }
+    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";
       }
-      const parsed = agentClaimedMessageSchema.safeParse(raw);
-      if (!parsed.success) {
-        throw new RegistryBrokerParseError(
-          "Unexpected claim response shape",
-          JSON.stringify(raw).slice(0, 500)
-        );
+    } else {
+      isValid = base64Regex.test(transactionBytes) && transactionBytes.length > 0;
+      if (!isValid) {
+        error = "Invalid base64 format";
       }
-      return parsed.data;
-    },
-    acknowledgeAgentMessage: (token, messageId, lease) => json(
-      `/agent-inbox/${encodePath(messageId)}/ack`,
-      agentMessageViewSchema,
-      { method: "POST", body: lease, token }
-    ),
-    renewAgentMessageLease: (token, messageId, input) => json(
-      `/agent-inbox/${encodePath(messageId)}/lease/renew`,
-      agentLeaseViewSchema,
-      { method: "POST", body: input, token }
-    ),
-    replyToAgentMessage: (token, messageId, input) => json(
-      `/agent-messages/${encodePath(messageId)}/reply`,
-      agentReplyResultSchema,
-      { method: "POST", body: input, token }
-    ),
-    rejectAgentMessage: (token, messageId, input) => json(
-      `/agent-messages/${encodePath(messageId)}/reject`,
-      agentMessageViewSchema,
-      { method: "POST", body: input, token }
-    ),
-    cancelAgentConversation: async (token, conversationId) => {
-      const raw = await client.requestJson(
-        `/agent-conversations/${encodePath(conversationId)}/cancel`,
-        { method: "POST", body: {}, headers: bearerHeaders(token) }
+    }
+    return {
+      isValid,
+      format,
+      error,
+      length: transactionBytes.length
+    };
+  }
+  /**
+   * 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 decodeTransactionBytes(transactionBytes) {
+    try {
+      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 (error) {
+      throw new TransactionParsingError(
+        "Failed to decode transaction bytes",
+        "DECODE_ERROR",
+        error instanceof Error ? error : void 0,
+        transactionBytes
       );
-      const parsed = z.object({
-        conversationId: z.string().uuid(),
-        canceledMessages: z.number()
-      }).safeParse(raw);
-      if (!parsed.success) {
-        throw new RegistryBrokerParseError(
-          "Unexpected cancel response shape",
-          JSON.stringify(raw).slice(0, 500)
-        );
+    }
+  }
+  /**
+   * Check if transaction bytes represent a valid Hedera transaction
+   */
+  static async isValidHederaTransaction(transactionBytes) {
+    try {
+      if (!this.validateTransactionBytes(transactionBytes).isValid) {
+        return false;
       }
-      return parsed.data;
-    },
-    waitForAgentReply: async (token, messageId, options) => {
-      const timeoutMs = options?.timeoutMs ?? 6e4;
-      const interval = Math.max(250, options?.pollIntervalMs ?? 2e3);
-      const deadline = Date.now() + timeoutMs;
-      while (Date.now() < deadline) {
-        const message = await json(
-          `/agent-messages/${encodePath(messageId)}`,
-          agentMessageViewSchema,
-          { token }
-        );
-        if (message.requestState === "completed") {
-          const conversation = await json(
-            `/agent-conversations/${encodePath(message.conversationId)}`,
-            agentConversationViewSchema,
-            { token }
+      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 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
+      );
+    }
+  }
+  /**
+   * 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 {
+      transactionId: transaction.transactionId?.toString(),
+      nodeAccountIds: transaction.nodeAccountIds?.map((id) => id.toString()) || [],
+      maxTransactionFee: transaction.maxTransactionFee?.toTinybars().toString() || "0",
+      memo: transaction._transactionMemo || void 0,
+      transfers: [],
+      tokenTransfers: []
+    };
+  }
+  /**
+   * Extract enhanced metadata from Transaction object
+   */
+  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()
+    };
+  }
+  /**
+   * 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 parseFromProtobuf(bytes) {
+    const result = {};
+    try {
+      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
           );
-          return conversation.messages.find(
-            (m) => m.inReplyTo === messageId && m.kind === "response"
-          ) ?? null;
+          Object.assign(result, details);
         }
-        if (message.requestState === "rejected" || message.requestState === "failed" || message.requestState === "expired" || message.requestState === "canceled") {
-          return null;
+      }
+    } catch (error) {
+    }
+    return result;
+  }
+  /**
+   * Intelligently merge all parsing results
+   */
+  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];
+      }
+    });
+  }
+  /**
+   * Apply schedulable transaction parsing using registry pattern
+   * Eliminates conditional logic in parseTransactionBody
+   */
+  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);
+    }
+  }
+  /**
+   * Parse transaction body details for all supported transaction types
+   * Uses a scalable registry pattern instead of if-else chains
+   */
+  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;
         }
-        await sleep(Math.min(interval, deadline - Date.now()), options?.signal);
       }
-      return null;
     }
-  };
+    return result;
+  }
+  /**
+   * Merge protobuf parsing results with parser results using registry pattern
+   * Eliminates transactionFields array and forEach logic
+   */
+  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);
+      }
+    }
+  }
+  /**
+   * 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;
+      }
+    }
+  }
+  /**
+   * Create fallback result when all parsing methods fail
+   */
+  static createFallbackResult(transactionBytes, primaryError, secondaryError) {
+    const validation = this.validateTransactionBytes(transactionBytes);
+    return {
+      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: {}
+    };
+  }
 }
 export {
-  agentClaimedMessageSchema,
-  agentConnectionStateSchema,
-  agentConversationViewSchema,
-  agentDeliveryStateSchema,
-  agentInboxItemSchema,
-  agentInboxListSchema,
-  agentLeaseViewSchema,
-  agentMessageAcceptedSchema,
-  agentMessageKindSchema,
-  agentMessageViewSchema,
-  agentNetworkProviderSchema,
-  agentPairingCompleteSchema,
-  agentPairingStartSchema,
-  agentProbeResultSchema,
-  agentReceiveModeSchema,
-  agentRegistrationStateSchema,
-  agentReplyResultSchema,
-  agentRequestStateSchema,
-  agentRuntimeQuoteSchema,
-  agentRuntimeRegistrationResultSchema,
-  agentRuntimeViewSchema,
-  createAgentNetworkApi
+  TransactionParser,
+  TransactionParsingError
 };
 //# sourceMappingURL=standards-sdk.es152.js.map