@hashgraphonline/standards-sdk 0.1.179 → 0.1.181

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

@@ -1,456 +1,203 @@
-import { proto } from "@hashgraph/proto";
-import { Long, Hbar, HbarUnit, ContractId, AccountId, FileId } from "@hashgraph/sdk";
-import { Buffer } from "buffer";
-import { hasTransactionType, parseKey } from "./standards-sdk.es170.js";
-class SCSParser {
-  /**
-   * Parse Smart Contract Service transaction using unified dual-branch approach
-   * This handles both regular transactions and signed transaction variants
-   */
-  static parseSCSTransaction(transaction, originalBytes) {
-    try {
-      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];
-            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 protoResult = this.parseFromProtobufTxBody(txBody);
-              if (protoResult.type && protoResult.type !== "UNKNOWN") {
-                return protoResult;
-              }
-            }
-          }
-        } catch (protoError) {
-        }
-      }
-      return this.parseFromTransactionInternals(transaction);
-    } catch (error) {
-      return {
-        type: "UNKNOWN",
-        humanReadableType: "Unknown Contract Transaction"
-      };
-    }
+import { parseSemicolonFields } from "./standards-sdk.es167.js";
+const ANS_HCS27_REGISTRY = "ans";
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function asString(value) {
+  if (typeof value !== "string") {
+    return null;
   }
-  /**
-   * Parse contract transaction from protobuf TransactionBody
-   * Handles all contract operations from decoded protobuf data
-   */
-  static parseFromProtobufTxBody(txBody) {
-    if (txBody.contractCall) {
-      const contractCall = this.parseContractCall(txBody.contractCall);
-      if (contractCall) {
-        return {
-          type: "CONTRACTCALL",
-          humanReadableType: "Contract Call",
-          contractCall
-        };
-      }
-    }
-    if (txBody.contractCreateInstance) {
-      const contractCreate = this.parseContractCreate(
-        txBody.contractCreateInstance
-      );
-      if (contractCreate) {
-        return {
-          type: "CONTRACTCREATE",
-          humanReadableType: "Contract Create",
-          contractCreate
-        };
-      }
-    }
-    if (txBody.contractUpdateInstance) {
-      const contractUpdate = this.parseContractUpdate(
-        txBody.contractUpdateInstance
-      );
-      if (contractUpdate) {
-        return {
-          type: "CONTRACTUPDATE",
-          humanReadableType: "Contract Update",
-          contractUpdate
-        };
-      }
-    }
-    if (txBody.contractDeleteInstance) {
-      const contractDelete = this.parseContractDelete(
-        txBody.contractDeleteInstance
-      );
-      if (contractDelete) {
-        return {
-          type: "CONTRACTDELETE",
-          humanReadableType: "Contract Delete",
-          contractDelete
-        };
-      }
-    }
-    if (txBody.ethereumTransaction) {
-      const ethereumCall = this.parseEthereumTransaction(
-        txBody.ethereumTransaction
-      );
-      if (ethereumCall) {
-        return {
-          type: "ETHEREUMTRANSACTION",
-          humanReadableType: "Ethereum Transaction",
-          ethereumTransaction: ethereumCall
-        };
-      }
-    }
-    return {};
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
   }
-  /**
-   * Extract contract data from Transaction internal fields
-   * This handles cases where data is stored in Transaction object internals
-   */
-  static parseFromTransactionInternals(transaction) {
-    try {
-      const tx = transaction;
-      if (tx._contractId && tx._gas) {
-        const contractCall = {
-          contractId: tx._contractId.toString(),
-          gas: typeof tx._gas === "number" ? tx._gas : Long.fromValue(tx._gas).toNumber(),
-          amount: tx._amount ? parseFloat(tx._amount.toString()) : 0
-        };
-        if (tx._functionParameters) {
-          const funcParams = Buffer.from(tx._functionParameters).toString(
-            "hex"
-          );
-          contractCall.functionParameters = funcParams;
-          contractCall.functionName = this.extractFunctionName(funcParams);
-        }
-        return {
-          type: "CONTRACTCALL",
-          humanReadableType: "Contract Call",
-          contractCall
-        };
-      }
-      if (hasTransactionType(transaction, "contractCreateInstance")) {
-        const contractCreate = {
-          gas: tx._gas.toString(),
-          initialBalance: tx._initialBalance?.toString() || "0"
-        };
-        if (tx._fileId) {
-          contractCreate.initcodeSource = "fileID";
-          contractCreate.initcode = tx._fileId.toString();
-        } else if (tx._bytecode) {
-          contractCreate.initcodeSource = "bytes";
-          contractCreate.initcode = Buffer.from(tx._bytecode).toString("hex");
-        }
-        if (tx._constructorParameters) {
-          contractCreate.constructorParameters = Buffer.from(
-            tx._constructorParameters
-          ).toString("hex");
-        }
-        if (tx._memo) contractCreate.memo = tx._memo;
-        if (tx._adminKey) contractCreate.adminKey = parseKey(tx._adminKey);
-        if (tx._maxAutomaticTokenAssociations !== void 0) {
-          contractCreate.maxAutomaticTokenAssociations = tx._maxAutomaticTokenAssociations;
-        }
-        if (tx._stakedAccountId) {
-          contractCreate.stakedAccountId = tx._stakedAccountId.toString();
-        } else if (tx._stakedNodeId !== null && tx._stakedNodeId !== void 0) {
-          contractCreate.stakedNodeId = Long.fromValue(
-            tx._stakedNodeId
-          ).toString();
-        }
-        if (tx._declineReward !== void 0)
-          contractCreate.declineReward = tx._declineReward;
-        if (tx._autoRenewPeriod)
-          contractCreate.autoRenewPeriod = tx._autoRenewPeriod.toString();
-        return {
-          type: "CONTRACTCREATE",
-          humanReadableType: "Contract Create",
-          contractCreate
-        };
-      }
-      if (hasTransactionType(transaction, "contractUpdateInstance")) {
-        const contractUpdate = {
-          contractIdToUpdate: tx._contractId.toString()
-        };
-        if (tx._memo) contractUpdate.memo = tx._memo;
-        if (tx._adminKey) contractUpdate.adminKey = parseKey(tx._adminKey);
-        if (tx._maxAutomaticTokenAssociations !== void 0) {
-          contractUpdate.maxAutomaticTokenAssociations = tx._maxAutomaticTokenAssociations;
-        }
-        if (tx._stakedAccountId) {
-          contractUpdate.stakedAccountId = tx._stakedAccountId.toString();
-        } else if (tx._stakedNodeId !== null && tx._stakedNodeId !== void 0) {
-          contractUpdate.stakedNodeId = Long.fromValue(
-            tx._stakedNodeId
-          ).toString();
-        }
-        if (tx._declineReward !== void 0)
-          contractUpdate.declineReward = tx._declineReward;
-        if (tx._autoRenewPeriod)
-          contractUpdate.autoRenewPeriod = tx._autoRenewPeriod.toString();
-        return {
-          type: "CONTRACTUPDATE",
-          humanReadableType: "Contract Update",
-          contractUpdate
-        };
-      }
-      if (hasTransactionType(transaction, "contractDeleteInstance")) {
-        const contractDelete = {
-          contractIdToDelete: tx._contractId.toString()
-        };
-        if (tx._transferAccountId) {
-          contractDelete.transferAccountId = tx._transferAccountId.toString();
-        } else if (tx._transferContractId) {
-          contractDelete.transferContractId = tx._transferContractId.toString();
-        }
-        return {
-          type: "CONTRACTDELETE",
-          humanReadableType: "Contract Delete",
-          contractDelete
-        };
-      }
-      return {};
-    } catch (error) {
-      return {};
-    }
+  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;
   }
-  /**
-   * Enhanced function name extraction from contract call parameters
-   * Attempts to decode function selector and map to known function names
-   */
-  static extractFunctionName(functionParameters) {
-    if (functionParameters.length < 8) return "unknown";
-    const selector = functionParameters.substring(0, 8);
-    const commonSelectors = {
-      a9059cbb: "transfer",
-      "095ea7b3": "approve",
-      "23b872dd": "transferFrom",
-      "70a08231": "balanceOf",
-      dd62ed3e: "allowance",
-      "18160ddd": "totalSupply",
-      "06fdde03": "name",
-      "95d89b41": "symbol",
-      "313ce567": "decimals",
-      "42842e0e": "safeTransferFrom",
-      b88d4fde: "safeTransferFrom",
-      e985e9c5: "isApprovedForAll",
-      a22cb465: "setApprovalForAll",
-      "6352211e": "ownerOf",
-      c87b56dd: "tokenURI",
-      "01ffc9a7": "supportsInterface",
-      "40c10f19": "mint",
-      "42966c68": "burn",
-      f2fde38b: "transferOwnership",
-      "715018a6": "renounceOwnership",
-      "8da5cb5b": "owner"
-    };
-    return commonSelectors[selector] || selector;
+  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
+  if (!isSemver(withoutPrefix)) {
+    return null;
   }
-  /**
-   * Parse Ethereum Transaction (was completely missing from original parser)
-   */
-  static parseEthereumTransaction(body) {
-    if (!body) return void 0;
-    const data = {
-      contractId: "EVM",
-      gas: body.maxGasAllowance ? Long.fromValue(body.maxGasAllowance).toNumber() : 0,
-      amount: 0
-    };
-    if (body.ethereumData && body.ethereumData.length > 0) {
-      const ethData = Buffer.from(body.ethereumData).toString("hex");
-      data.functionParameters = ethData;
-      if (ethData.length >= 8) {
-        data.functionName = this.extractFunctionName(ethData);
-      }
-    }
-    return data;
+  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;
   }
-  static parseContractCall(body) {
-    if (!body) return void 0;
-    const hbarAmount = Hbar.fromTinybars(Long.fromValue(body.amount ?? 0));
-    const data = {
-      contractId: new ContractId(
-        body.contractID.shardNum ?? 0,
-        body.contractID.realmNum ?? 0,
-        body.contractID.contractNum ?? 0
-      ).toString(),
-      gas: Long.fromValue(body.gas ?? 0).toNumber(),
-      amount: parseFloat(hbarAmount.toString(HbarUnit.Hbar))
-    };
-    if (body.functionParameters) {
-      data.functionParameters = Buffer.from(body.functionParameters).toString(
-        "hex"
-      );
-      if (data.functionParameters.length >= 8) {
-        data.functionName = this.extractFunctionName(data.functionParameters);
-      }
-    }
-    return data;
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(urlValue);
+  } catch {
+    return null;
   }
-  static parseContractCreate(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.initialBalance) {
-      data.initialBalance = Hbar.fromTinybars(
-        Long.fromValue(body.initialBalance)
-      ).toString(HbarUnit.Hbar);
-    }
-    if (body.gas) {
-      data.gas = Long.fromValue(body.gas).toString();
-    }
-    if (body.adminKey) {
-      data.adminKey = parseKey(body.adminKey);
-    }
-    if (body.constructorParameters) {
-      data.constructorParameters = Buffer.from(
-        body.constructorParameters
-      ).toString("hex");
-    }
-    if (body.memo) {
-      data.memo = body.memo;
-    }
-    if (body.autoRenewPeriod?.seconds) {
-      data.autoRenewPeriod = Long.fromValue(
-        body.autoRenewPeriod.seconds
-      ).toString();
-    }
-    if (body.stakedAccountId) {
-      data.stakedAccountId = new AccountId(
-        body.stakedAccountId.shardNum ?? 0,
-        body.stakedAccountId.realmNum ?? 0,
-        body.stakedAccountId.accountNum ?? 0
-      ).toString();
-    } else if (body.stakedNodeId !== null && body.stakedNodeId !== void 0) {
-      data.stakedNodeId = Long.fromValue(body.stakedNodeId).toString();
-    }
-    if (body.declineReward !== void 0) {
-      data.declineReward = body.declineReward;
-    }
-    if (body.maxAutomaticTokenAssociations !== void 0) {
-      data.maxAutomaticTokenAssociations = body.maxAutomaticTokenAssociations;
-    }
-    if (body.fileID) {
-      data.initcodeSource = "fileID";
-      data.initcode = new FileId(
-        body.fileID.shardNum ?? 0,
-        body.fileID.realmNum ?? 0,
-        body.fileID.fileNum ?? 0
-      ).toString();
-    } else if (body.initcode && body.initcode.length > 0) {
-      data.initcodeSource = "bytes";
-      data.initcode = Buffer.from(body.initcode).toString("hex");
-    }
-    return data;
+  if (parsedUrl.protocol.toLowerCase() !== "https:") {
+    return null;
   }
-  static parseContractUpdate(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.contractID) {
-      data.contractIdToUpdate = new ContractId(
-        body.contractID.shardNum ?? 0,
-        body.contractID.realmNum ?? 0,
-        body.contractID.contractNum ?? 0
-      ).toString();
-    }
-    if (body.adminKey) {
-      data.adminKey = parseKey(body.adminKey);
-    }
-    if (body.expirationTime?.seconds) {
-      data.expirationTime = `${Long.fromValue(
-        body.expirationTime.seconds
-      ).toString()}.${body.expirationTime.nanos}`;
-    }
-    if (body.autoRenewPeriod?.seconds) {
-      data.autoRenewPeriod = Long.fromValue(
-        body.autoRenewPeriod.seconds
-      ).toString();
-    }
-    if (body.memo) {
-      const memoUnion = body.memo;
-      if (memoUnion && typeof memoUnion === "object" && Object.prototype.hasOwnProperty.call(memoUnion, "value")) {
-        const value = memoUnion.value;
-        if (value === null || value === void 0) {
-          data.memo = void 0;
-        } else {
-          data.memo = String(value);
-        }
-      } else if (typeof memoUnion === "string") {
-        data.memo = memoUnion;
-      } else {
-        data.memo = void 0;
-      }
-    } else {
-      data.memo = void 0;
-    }
-    if (body.stakedAccountId) {
-      data.stakedAccountId = new AccountId(
-        body.stakedAccountId.shardNum ?? 0,
-        body.stakedAccountId.realmNum ?? 0,
-        body.stakedAccountId.accountNum ?? 0
-      ).toString();
-      data.stakedNodeId = void 0;
-    } else if (body.stakedNodeId !== null && body.stakedNodeId !== void 0 && Long.fromValue(body.stakedNodeId).notEquals(-1)) {
-      data.stakedNodeId = Long.fromValue(body.stakedNodeId).toString();
-      data.stakedAccountId = void 0;
-    } else {
-      data.stakedNodeId = void 0;
-      data.stakedAccountId = void 0;
-    }
-    if (body.declineReward?.value !== void 0) {
-      data.declineReward = body.declineReward.value;
-    }
-    if (body.maxAutomaticTokenAssociations?.value !== void 0) {
-      data.maxAutomaticTokenAssociations = body.maxAutomaticTokenAssociations.value;
-    }
-    if (body.autoRenewAccountId) {
-      data.autoRenewAccountId = new AccountId(
-        body.autoRenewAccountId.shardNum ?? 0,
-        body.autoRenewAccountId.realmNum ?? 0,
-        body.autoRenewAccountId.accountNum ?? 0
-      ).toString();
+  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 data;
   }
-  static parseContractDelete(body) {
-    if (!body) return void 0;
-    const data = {};
-    if (body.contractID) {
-      data.contractIdToDelete = new ContractId(
-        body.contractID.shardNum ?? 0,
-        body.contractID.realmNum ?? 0,
-        body.contractID.contractNum ?? 0
-      ).toString();
+  return false;
+}
+function extractEndpointCandidates(endpoints, supportedSchemes) {
+  const candidates = [];
+  for (const [key, value] of Object.entries(endpoints)) {
+    if (!isObjectRecord(value)) {
+      continue;
     }
-    if (body.transferAccountID) {
-      data.transferAccountId = new AccountId(
-        body.transferAccountID.shardNum ?? 0,
-        body.transferAccountID.realmNum ?? 0,
-        body.transferAccountID.accountNum ?? 0
-      ).toString();
-    } else if (body.transferContractID) {
-      data.transferContractId = new ContractId(
-        body.transferContractID.shardNum ?? 0,
-        body.transferContractID.realmNum ?? 0,
-        body.transferContractID.contractNum ?? 0
-      ).toString();
+    const endpoint = asString(value["url"]);
+    if (!endpoint) {
+      continue;
     }
-    return data;
+    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;
   }
-  /**
-   * Parse SCS (Smart Contract Service) transaction from Transaction object
-   * This is the unified entry point that delegates to the comprehensive parsing logic
-   */
-  static parseFromTransactionObject(transaction) {
-    return this.parseSCSTransaction(transaction);
+  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 {
-  SCSParser
+  extractEndpointCandidates,
+  isValidAnsProfileVersion,
+  normalizeAnsVersion,
+  parseAnsAgentCard,
+  parseAnsDnsTxtRecord,
+  selectPreferredEndpoint,
+  toErrorMessage
 };
 //# sourceMappingURL=standards-sdk.es168.js.map