@hashgraphonline/standards-sdk 0.1.184 → 0.1.186

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

@@ -0,0 +1,203 @@
+import { parseSemicolonFields } from "./standards-sdk.es190.js";
+const ANS_HCS27_REGISTRY = "ans";
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function asString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  return trimmed;
+}
+function isSemver(value) {
+  return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(
+    value
+  );
+}
+function normalizeAnsVersion(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
+  if (!isSemver(withoutPrefix)) {
+    return null;
+  }
+  return withoutPrefix;
+}
+function parseAnsDnsTxtRecord(rawRecord) {
+  const fields = parseSemicolonFields(rawRecord);
+  const version = fields["v"];
+  const urlValue = fields["url"];
+  if (!version || !urlValue || version.toLowerCase() !== "ans1") {
+    return null;
+  }
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(urlValue);
+  } catch {
+    return null;
+  }
+  if (parsedUrl.protocol.toLowerCase() !== "https:") {
+    return null;
+  }
+  const rawAnsVersion = fields["version"];
+  let normalizedAnsVersion;
+  if (rawAnsVersion !== void 0) {
+    const parsedVersion = normalizeAnsVersion(rawAnsVersion);
+    if (!parsedVersion) {
+      return null;
+    }
+    normalizedAnsVersion = parsedVersion;
+  }
+  return {
+    version: normalizedAnsVersion,
+    url: parsedUrl.toString()
+  };
+}
+function isValidAnsProfileVersion(value) {
+  return !!value && normalizeAnsVersion(value) !== null;
+}
+function hasProtocolPathSegment(pathname, protocol) {
+  const normalizedProtocol = protocol.trim().toLowerCase();
+  if (!normalizedProtocol) {
+    return false;
+  }
+  const pathSegments = pathname.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+  for (const segment of pathSegments) {
+    if (segment.toLowerCase() === normalizedProtocol) {
+      return true;
+    }
+  }
+  return false;
+}
+function extractEndpointCandidates(endpoints, supportedSchemes) {
+  const candidates = [];
+  for (const [key, value] of Object.entries(endpoints)) {
+    if (!isObjectRecord(value)) {
+      continue;
+    }
+    const endpoint = asString(value["url"]);
+    if (!endpoint) {
+      continue;
+    }
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(endpoint);
+    } catch {
+      continue;
+    }
+    const scheme = parsedUrl.protocol.replace(/:$/, "").toLowerCase();
+    if (!supportedSchemes.has(scheme)) {
+      continue;
+    }
+    candidates.push({
+      key,
+      endpointUrl: parsedUrl.toString(),
+      parsedUrl
+    });
+  }
+  return candidates;
+}
+function validateAnsHcs27Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const checkpointTopicId = asString(input["checkpoint_topic_id"]);
+  const registry = asString(input["registry"]);
+  const logId = asString(input["log_id"]);
+  if (!checkpointTopicId || !registry || !logId || registry !== ANS_HCS27_REGISTRY) {
+    return void 0;
+  }
+  const checkpointUri = asString(input["checkpoint_uri"]) ?? void 0;
+  const viewerUri = asString(input["viewer_uri"]) ?? void 0;
+  return {
+    checkpointTopicId,
+    registry,
+    logId,
+    checkpointUri,
+    viewerUri
+  };
+}
+function validateHcs28Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const directoryTopicId = asString(input["directory_topic_id"]);
+  const tId = asString(input["t_id"]);
+  const agentId = asString(input["agent_id"]);
+  if (!directoryTopicId || !tId || !agentId) {
+    return void 0;
+  }
+  const proofProfile = asString(input["proof_profile"]) ?? void 0;
+  return {
+    directoryTopicId,
+    tId,
+    agentId,
+    proofProfile
+  };
+}
+function parseTransparencyHints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const hcs27 = validateAnsHcs27Hints(input["hcs27"]);
+  const hcs28 = validateHcs28Hints(input["hcs28"]);
+  if (!hcs27 && !hcs28) {
+    return void 0;
+  }
+  return {
+    hcs27,
+    hcs28
+  };
+}
+function parseAnsAgentCard(input) {
+  if (!isObjectRecord(input)) {
+    return null;
+  }
+  const ansName = asString(input["ansName"]);
+  const endpoints = input["endpoints"];
+  if (!ansName || !isObjectRecord(endpoints)) {
+    return null;
+  }
+  return {
+    ansName,
+    endpoints,
+    transparencyHints: parseTransparencyHints(input["transparency"])
+  };
+}
+function selectPreferredEndpoint(candidates, protocol) {
+  if (candidates.length === 0) {
+    return null;
+  }
+  const sortedCandidates = [...candidates].sort(
+    (a, b) => a.key.localeCompare(b.key)
+  );
+  const protocolMatches = sortedCandidates.filter(
+    (candidate) => hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol)
+  );
+  if (protocolMatches.length > 0) {
+    return protocolMatches[0];
+  }
+  return sortedCandidates[0];
+}
+function toErrorMessage(error) {
+  if (error instanceof Error && error.message) {
+    return error.message;
+  }
+  return null;
+}
+export {
+  extractEndpointCandidates,
+  isValidAnsProfileVersion,
+  normalizeAnsVersion,
+  parseAnsAgentCard,
+  parseAnsDnsTxtRecord,
+  selectPreferredEndpoint,
+  toErrorMessage
+};
+//# sourceMappingURL=standards-sdk.es191.js.map

package/dist/es/standards-sdk.es191.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-sdk.es191.js","sources":["../../src/hcs-14/resolvers/ans-dns-web-profile-utils.ts"],"sourcesContent":["import type {\n  ProfileResolutionHcs27TransparencyHints,\n  ProfileResolutionHcs28TransparencyHints,\n  ProfileResolutionTransparencyHints,\n} from './types';\nimport { parseSemicolonFields } from './profile-utils';\n\nexport interface AnsDnsTxtRecord {\n  version?: string;\n  url: string;\n}\n\nexport interface AnsEndpointCandidate {\n  key: string;\n  endpointUrl: string;\n  parsedUrl: URL;\n}\n\nexport interface ParsedAnsAgentCard {\n  ansName: string;\n  endpoints: Record<string, unknown>;\n  transparencyHints?: ProfileResolutionTransparencyHints;\n}\n\nconst ANS_HCS27_REGISTRY = 'ans';\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asString(value: unknown): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  return trimmed;\n}\n\nfunction isSemver(value: string): boolean {\n  return /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/.test(\n    value,\n  );\n}\n\nexport function normalizeAnsVersion(value: string): string | null {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  const withoutPrefix =\n    trimmed.startsWith('v') || trimmed.startsWith('V')\n      ? trimmed.slice(1)\n      : trimmed;\n  if (!isSemver(withoutPrefix)) {\n    return null;\n  }\n  return withoutPrefix;\n}\n\nexport function parseAnsDnsTxtRecord(\n  rawRecord: string,\n): AnsDnsTxtRecord | null {\n  const fields = parseSemicolonFields(rawRecord);\n  const version = fields['v'];\n  const urlValue = fields['url'];\n  if (!version || !urlValue || version.toLowerCase() !== 'ans1') {\n    return null;\n  }\n\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(urlValue);\n  } catch {\n    return null;\n  }\n\n  if (parsedUrl.protocol.toLowerCase() !== 'https:') {\n    return null;\n  }\n\n  const rawAnsVersion = fields['version'];\n  let normalizedAnsVersion: string | undefined;\n  if (rawAnsVersion !== undefined) {\n    const parsedVersion = normalizeAnsVersion(rawAnsVersion);\n    if (!parsedVersion) {\n      return null;\n    }\n    normalizedAnsVersion = parsedVersion;\n  }\n\n  return {\n    version: normalizedAnsVersion,\n    url: parsedUrl.toString(),\n  };\n}\n\nexport function isValidAnsProfileVersion(value: string | undefined): boolean {\n  return !!value && normalizeAnsVersion(value) !== null;\n}\n\nfunction hasProtocolPathSegment(pathname: string, protocol: string): boolean {\n  const normalizedProtocol = protocol.trim().toLowerCase();\n  if (!normalizedProtocol) {\n    return false;\n  }\n\n  const pathSegments = pathname\n    .split('/')\n    .map(segment => segment.trim())\n    .filter(segment => segment.length > 0);\n  for (const segment of pathSegments) {\n    if (segment.toLowerCase() === normalizedProtocol) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function extractEndpointCandidates(\n  endpoints: Record<string, unknown>,\n  supportedSchemes: Set<string>,\n): AnsEndpointCandidate[] {\n  const candidates: AnsEndpointCandidate[] = [];\n  for (const [key, value] of Object.entries(endpoints)) {\n    if (!isObjectRecord(value)) {\n      continue;\n    }\n    const endpoint = asString(value['url']);\n    if (!endpoint) {\n      continue;\n    }\n\n    let parsedUrl: URL;\n    try {\n      parsedUrl = new URL(endpoint);\n    } catch {\n      continue;\n    }\n\n    const scheme = parsedUrl.protocol.replace(/:$/, '').toLowerCase();\n    if (!supportedSchemes.has(scheme)) {\n      continue;\n    }\n\n    candidates.push({\n      key,\n      endpointUrl: parsedUrl.toString(),\n      parsedUrl,\n    });\n  }\n\n  return candidates;\n}\n\nfunction validateAnsHcs27Hints(\n  input: unknown,\n): ProfileResolutionHcs27TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const checkpointTopicId = asString(input['checkpoint_topic_id']);\n  const registry = asString(input['registry']);\n  const logId = asString(input['log_id']);\n  if (\n    !checkpointTopicId ||\n    !registry ||\n    !logId ||\n    registry !== ANS_HCS27_REGISTRY\n  ) {\n    return undefined;\n  }\n  const checkpointUri = asString(input['checkpoint_uri']) ?? undefined;\n  const viewerUri = asString(input['viewer_uri']) ?? undefined;\n  return {\n    checkpointTopicId,\n    registry,\n    logId,\n    checkpointUri,\n    viewerUri,\n  };\n}\n\nfunction validateHcs28Hints(\n  input: unknown,\n): ProfileResolutionHcs28TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const directoryTopicId = asString(input['directory_topic_id']);\n  const tId = asString(input['t_id']);\n  const agentId = asString(input['agent_id']);\n  if (!directoryTopicId || !tId || !agentId) {\n    return undefined;\n  }\n  const proofProfile = asString(input['proof_profile']) ?? undefined;\n  return {\n    directoryTopicId,\n    tId,\n    agentId,\n    proofProfile,\n  };\n}\n\nfunction parseTransparencyHints(\n  input: unknown,\n): ProfileResolutionTransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const hcs27 = validateAnsHcs27Hints(input['hcs27']);\n  const hcs28 = validateHcs28Hints(input['hcs28']);\n  if (!hcs27 && !hcs28) {\n    return undefined;\n  }\n  return {\n    hcs27,\n    hcs28,\n  };\n}\n\nexport function parseAnsAgentCard(input: unknown): ParsedAnsAgentCard | null {\n  if (!isObjectRecord(input)) {\n    return null;\n  }\n  const ansName = asString(input['ansName']);\n  const endpoints = input['endpoints'];\n  if (!ansName || !isObjectRecord(endpoints)) {\n    return null;\n  }\n  return {\n    ansName,\n    endpoints,\n    transparencyHints: parseTransparencyHints(input['transparency']),\n  };\n}\n\nexport function selectPreferredEndpoint(\n  candidates: AnsEndpointCandidate[],\n  protocol: string,\n): AnsEndpointCandidate | null {\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  const sortedCandidates = [...candidates].sort((a, b) =>\n    a.key.localeCompare(b.key),\n  );\n  const protocolMatches = sortedCandidates.filter(candidate =>\n    hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol),\n  );\n  if (protocolMatches.length > 0) {\n    return protocolMatches[0];\n  }\n  return sortedCandidates[0];\n}\n\nexport function toErrorMessage(error: unknown): string | null {\n  if (error instanceof Error && error.message) {\n    return error.message;\n  }\n  return null;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,175 @@
+import { Long, AccountId } from "@hashgraph/sdk";
+import { parseKey } from "./standards-sdk.es197.js";
+import { Buffer } from "buffer";
+class HCSParser {
+  static parseConsensusCreateTopic(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.memo) {
+      data.memo = body.memo;
+    }
+    data.adminKey = parseKey(body.adminKey);
+    data.submitKey = parseKey(body.submitKey);
+    if (body.autoRenewPeriod?.seconds) {
+      data.autoRenewPeriod = Long.fromValue(
+        body.autoRenewPeriod.seconds
+      ).toString();
+    }
+    if (body.autoRenewAccount) {
+      data.autoRenewAccountId = new AccountId(
+        body.autoRenewAccount.shardNum ?? 0,
+        body.autoRenewAccount.realmNum ?? 0,
+        body.autoRenewAccount.accountNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseConsensusSubmitMessage(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.topicID) {
+      data.topicId = `${body.topicID.shardNum ?? 0}.${body.topicID.realmNum ?? 0}.${body.topicID.topicNum ?? 0}`;
+    }
+    if (body.message?.length > 0) {
+      const messageBuffer = Buffer.from(body.message);
+      const utf8String = messageBuffer.toString("utf8");
+      if (/[\x00-\x08\x0B\x0E-\x1F\x7F]/.test(utf8String) || utf8String.includes("�")) {
+        data.message = messageBuffer.toString("base64");
+        data.messageEncoding = "base64";
+      } else {
+        data.message = utf8String;
+        data.messageEncoding = "utf8";
+      }
+    }
+    if (body.chunkInfo) {
+      if (body.chunkInfo.initialTransactionID) {
+        const txId = body.chunkInfo.initialTransactionID.accountID;
+        const taValidStart = body.chunkInfo.initialTransactionID.transactionValidStart;
+        if (txId && taValidStart) {
+          data.chunkInfoInitialTransactionID = `${txId.shardNum ?? 0}.${txId.realmNum ?? 0}.${txId.accountNum ?? 0}@${taValidStart.seconds ?? 0}.${taValidStart.nanos ?? 0}`;
+        }
+      }
+      if (body.chunkInfo.number !== void 0 && body.chunkInfo.number !== null) {
+        data.chunkInfoNumber = body.chunkInfo.number;
+      }
+      if (body.chunkInfo.total !== void 0 && body.chunkInfo.total !== null) {
+        data.chunkInfoTotal = body.chunkInfo.total;
+      }
+    }
+    return data;
+  }
+  static parseConsensusUpdateTopic(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.topicID) {
+      data.topicId = `${body.topicID.shardNum}.${body.topicID.realmNum}.${body.topicID.topicNum}`;
+    }
+    if (body.memo?.value !== void 0) {
+      data.memo = body.memo.value;
+    }
+    if (body.adminKey === null) {
+      data.clearAdminKey = true;
+      data.adminKey = void 0;
+    } else if (body.adminKey) {
+      data.adminKey = parseKey(body.adminKey);
+    } else {
+      data.adminKey = void 0;
+    }
+    if (body.submitKey === null) {
+      data.clearSubmitKey = true;
+      data.submitKey = void 0;
+    } else if (body.submitKey) {
+      data.submitKey = parseKey(body.submitKey);
+    } else {
+      data.submitKey = void 0;
+    }
+    if (body.autoRenewPeriod?.seconds) {
+      data.autoRenewPeriod = Long.fromValue(
+        body.autoRenewPeriod.seconds
+      ).toString();
+    }
+    if (body.autoRenewAccount) {
+      data.autoRenewAccountId = new AccountId(
+        body.autoRenewAccount.shardNum ?? 0,
+        body.autoRenewAccount.realmNum ?? 0,
+        body.autoRenewAccount.accountNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseConsensusDeleteTopic(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.topicID) {
+      data.topicId = `${body.topicID.shardNum}.${body.topicID.realmNum ?? 0}.${body.topicID.topicNum ?? 0}`;
+    }
+    return data;
+  }
+  /**
+   * Parse HCS transaction from Transaction object with comprehensive extraction
+   * This is the unified entry point that handles both protobuf and internal field extraction
+   */
+  static parseFromTransactionObject(transaction) {
+    try {
+      const transactionBody = transaction._transactionBody;
+      if (!transactionBody) {
+        return {};
+      }
+      if (transactionBody.consensusCreateTopic) {
+        const consensusCreateTopic = this.parseConsensusCreateTopic(
+          transactionBody.consensusCreateTopic
+        );
+        if (consensusCreateTopic) {
+          return {
+            type: "TOPICCREATE",
+            humanReadableType: "Topic Create",
+            consensusCreateTopic
+          };
+        }
+      }
+      if (transactionBody.consensusSubmitMessage) {
+        const consensusSubmitMessage = this.parseConsensusSubmitMessage(
+          transactionBody.consensusSubmitMessage
+        );
+        if (consensusSubmitMessage) {
+          return {
+            type: "CONSENSUSSUBMITMESSAGE",
+            humanReadableType: "Submit Message",
+            consensusSubmitMessage
+          };
+        }
+      }
+      if (transactionBody.consensusUpdateTopic) {
+        const consensusUpdateTopic = this.parseConsensusUpdateTopic(
+          transactionBody.consensusUpdateTopic
+        );
+        if (consensusUpdateTopic) {
+          return {
+            type: "TOPICUPDATE",
+            humanReadableType: "Topic Update",
+            consensusUpdateTopic
+          };
+        }
+      }
+      if (transactionBody.consensusDeleteTopic) {
+        const consensusDeleteTopic = this.parseConsensusDeleteTopic(
+          transactionBody.consensusDeleteTopic
+        );
+        if (consensusDeleteTopic) {
+          return {
+            type: "TOPICDELETE",
+            humanReadableType: "Topic Delete",
+            consensusDeleteTopic
+          };
+        }
+      }
+      return {};
+    } catch (error) {
+      return {};
+    }
+  }
+}
+export {
+  HCSParser
+};
+//# sourceMappingURL=standards-sdk.es192.js.map

package/dist/es/standards-sdk.es192.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standards-sdk.es192.js","sources":["../../src/utils/parsers/hcs-parser.ts"],"sourcesContent":["import { proto } from '@hashgraph/proto';\nimport { AccountId, Long, Transaction } from '@hashgraph/sdk';\nimport {\n  ConsensusCreateTopicData,\n  ConsensusSubmitMessageData,\n  ConsensusUpdateTopicData,\n  ConsensusDeleteTopicData,\n} from '../transaction-parser-types';\nimport { parseKey } from './parser-utils';\nimport { Buffer } from 'buffer';\n\nexport class HCSParser {\n  static parseConsensusCreateTopic(\n    body: proto.IConsensusCreateTopicTransactionBody,\n  ): ConsensusCreateTopicData | undefined {\n    if (!body) return undefined;\n    const data: ConsensusCreateTopicData = {};\n    if (body.memo) {\n      data.memo = body.memo;\n    }\n    data.adminKey = parseKey(body.adminKey);\n    data.submitKey = parseKey(body.submitKey);\n    if (body.autoRenewPeriod?.seconds) {\n      data.autoRenewPeriod = Long.fromValue(\n        body.autoRenewPeriod.seconds,\n      ).toString();\n    }\n    if (body.autoRenewAccount) {\n      data.autoRenewAccountId = new AccountId(\n        body.autoRenewAccount.shardNum ?? 0,\n        body.autoRenewAccount.realmNum ?? 0,\n        body.autoRenewAccount.accountNum ?? 0,\n      ).toString();\n    }\n    return data;\n  }\n\n  static parseConsensusSubmitMessage(\n    body: proto.IConsensusSubmitMessageTransactionBody,\n  ): ConsensusSubmitMessageData | undefined {\n    if (!body) return undefined;\n    const data: ConsensusSubmitMessageData = {};\n    if (body.topicID) {\n      data.topicId = `${body.topicID.shardNum ?? 0}.${\n        body.topicID.realmNum ?? 0\n      }.${body.topicID.topicNum ?? 0}`;\n    }\n    if (body.message?.length > 0) {\n      const messageBuffer = Buffer.from(body.message);\n      const utf8String = messageBuffer.toString('utf8');\n      if (\n        /[\\x00-\\x08\\x0B\\x0E-\\x1F\\x7F]/.test(utf8String) ||\n        utf8String.includes('\\uFFFD')\n      ) {\n        data.message = messageBuffer.toString('base64');\n        data.messageEncoding = 'base64';\n      } else {\n        data.message = utf8String;\n        data.messageEncoding = 'utf8';\n      }\n    }\n    if (body.chunkInfo) {\n      if (body.chunkInfo.initialTransactionID) {\n        const txId = body.chunkInfo.initialTransactionID.accountID;\n        const taValidStart =\n          body.chunkInfo.initialTransactionID.transactionValidStart;\n        if (txId && taValidStart) {\n          data.chunkInfoInitialTransactionID = `${txId.shardNum ?? 0}.${\n            txId.realmNum ?? 0\n          }.${txId.accountNum ?? 0}@${taValidStart.seconds ?? 0}.${\n            taValidStart.nanos ?? 0\n          }`;\n        }\n      }\n      if (\n        body.chunkInfo.number !== undefined &&\n        body.chunkInfo.number !== null\n      ) {\n        data.chunkInfoNumber = body.chunkInfo.number;\n      }\n      if (body.chunkInfo.total !== undefined && body.chunkInfo.total !== null) {\n        data.chunkInfoTotal = body.chunkInfo.total;\n      }\n    }\n    return data;\n  }\n\n  static parseConsensusUpdateTopic(\n    body: proto.IConsensusUpdateTopicTransactionBody,\n  ): ConsensusUpdateTopicData | undefined {\n    if (!body) return undefined;\n    const data: ConsensusUpdateTopicData = {};\n    if (body.topicID) {\n      data.topicId = `${body.topicID.shardNum}.${body.topicID.realmNum}.${body.topicID.topicNum}`;\n    }\n    if (body.memo?.value !== undefined) {\n      data.memo = body.memo.value;\n    }\n    if (body.adminKey === null) {\n      data.clearAdminKey = true;\n      data.adminKey = undefined;\n    } else if (body.adminKey) {\n      data.adminKey = parseKey(body.adminKey);\n    } else {\n      data.adminKey = undefined;\n    }\n    if (body.submitKey === null) {\n      data.clearSubmitKey = true;\n      data.submitKey = undefined;\n    } else if (body.submitKey) {\n      data.submitKey = parseKey(body.submitKey);\n    } else {\n      data.submitKey = undefined;\n    }\n    if (body.autoRenewPeriod?.seconds) {\n      data.autoRenewPeriod = Long.fromValue(\n        body.autoRenewPeriod.seconds,\n      ).toString();\n    }\n    if (body.autoRenewAccount) {\n      data.autoRenewAccountId = new AccountId(\n        body.autoRenewAccount.shardNum ?? 0,\n        body.autoRenewAccount.realmNum ?? 0,\n        body.autoRenewAccount.accountNum ?? 0,\n      ).toString();\n    }\n    return data;\n  }\n\n  static parseConsensusDeleteTopic(\n    body: proto.IConsensusDeleteTopicTransactionBody,\n  ): ConsensusDeleteTopicData | undefined {\n    if (!body) return undefined;\n    const data: ConsensusDeleteTopicData = {};\n    if (body.topicID) {\n      data.topicId = `${body.topicID.shardNum}.${body.topicID.realmNum ?? 0}.${\n        body.topicID.topicNum ?? 0\n      }`;\n    }\n    return data;\n  }\n\n  /**\n   * Parse HCS transaction from Transaction object with comprehensive extraction\n   * This is the unified entry point that handles both protobuf and internal field extraction\n   */\n  static parseFromTransactionObject(transaction: Transaction): {\n    type?: string;\n    humanReadableType?: string;\n    [key: string]: unknown;\n  } {\n    try {\n      const transactionBody = (\n        transaction as unknown as { _transactionBody?: unknown }\n      )._transactionBody as proto.ITransactionBody | undefined;\n\n      if (!transactionBody) {\n        return {};\n      }\n\n      if (transactionBody.consensusCreateTopic) {\n        const consensusCreateTopic = this.parseConsensusCreateTopic(\n          transactionBody.consensusCreateTopic,\n        );\n        if (consensusCreateTopic) {\n          return {\n            type: 'TOPICCREATE',\n            humanReadableType: 'Topic Create',\n            consensusCreateTopic,\n          };\n        }\n      }\n\n      if (transactionBody.consensusSubmitMessage) {\n        const consensusSubmitMessage = this.parseConsensusSubmitMessage(\n          transactionBody.consensusSubmitMessage,\n        );\n        if (consensusSubmitMessage) {\n          return {\n            type: 'CONSENSUSSUBMITMESSAGE',\n            humanReadableType: 'Submit Message',\n            consensusSubmitMessage,\n          };\n        }\n      }\n\n      if (transactionBody.consensusUpdateTopic) {\n        const consensusUpdateTopic = this.parseConsensusUpdateTopic(\n          transactionBody.consensusUpdateTopic,\n        );\n        if (consensusUpdateTopic) {\n          return {\n            type: 'TOPICUPDATE',\n            humanReadableType: 'Topic Update',\n            consensusUpdateTopic,\n          };\n        }\n      }\n\n      if (transactionBody.consensusDeleteTopic) {\n        const consensusDeleteTopic = this.parseConsensusDeleteTopic(\n          transactionBody.consensusDeleteTopic,\n        );\n        if (consensusDeleteTopic) {\n          return {\n            type: 'TOPICDELETE',\n            humanReadableType: 'Topic Delete',\n            consensusDeleteTopic,\n          };\n        }\n      }\n\n      return {};\n    } catch (error) {\n      return {};\n    }\n  }\n}\n"],"names":[],"mappings":"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"}