@hashgraphonline/standards-sdk 0.1.136 → 0.1.137-feat-hcs-21.canary.5802d65.32

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

@@ -1,20 +1,68 @@
-import { Logger } from "./standards-sdk.es99.js";
-import { HederaMirrorNode } from "./standards-sdk.es120.js";
-class HCS5BaseClient {
+import { Logger } from "./standards-sdk.es105.js";
+const REFERENCE_THRESHOLD = 50 * 1024;
+class ContentStoreServiceImpl {
+  constructor() {
+    this.contentStore = null;
+    this.logger = Logger.getInstance({ module: "ContentStoreService" });
+  }
+  static getInstance() {
+    if (!ContentStoreServiceImpl._instance) {
+      ContentStoreServiceImpl._instance = new ContentStoreServiceImpl();
+    }
+    return ContentStoreServiceImpl._instance;
+  }
+  /**
+   * Set the content store instance
+   */
+  async setInstance(store) {
+    if (this.contentStore) {
+      this.logger.warn("Content store already set, replacing");
+    }
+    this.contentStore = store;
+    this.logger.info("Content store instance set");
+  }
+  /**
+   * Get the content store instance
+   */
+  getInstance() {
+    return this.contentStore;
+  }
   /**
-   * Create a new HCS-5 base client
+   * Clear the content store instance
    */
-  constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger || Logger.getInstance({
-      level: config.logLevel || "info",
-      module: "HCS5Client",
-      silent: config.silent
-    });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
+  dispose() {
+    this.contentStore = null;
+    this.logger.info("Content store disposed");
   }
+  /**
+   * Check if content store is available
+   */
+  isAvailable() {
+    return this.contentStore !== null;
+  }
+}
+function extractReferenceId(input) {
+  const trimmed = input.trim();
+  const exactMatch = trimmed.match(/^content-ref:([a-f0-9]+)$/);
+  if (exactMatch) {
+    return exactMatch[1];
+  }
+  const embeddedMatch = trimmed.match(/content-ref:([a-f0-9]+)/);
+  if (embeddedMatch) {
+    return embeddedMatch[1];
+  }
+  return null;
+}
+function shouldUseReference(content) {
+  const size = typeof content === "string" ? Buffer.byteLength(content, "utf8") : content.length;
+  return size > REFERENCE_THRESHOLD;
 }
+const ContentStoreService = ContentStoreServiceImpl.getInstance();
 export {
-  HCS5BaseClient
+  ContentStoreService,
+  ContentStoreServiceImpl,
+  REFERENCE_THRESHOLD,
+  extractReferenceId,
+  shouldUseReference
 };
 //# sourceMappingURL=standards-sdk.es133.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/hcs-5/base-client.ts"],"sourcesContent":["import { Logger, ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { HCS5ClientConfig } from './types';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Base client for HCS-5 operations\n */\nexport abstract class HCS5BaseClient {\n  protected logger: ILogger;\n  protected mirrorNode: HederaMirrorNode;\n  protected network: NetworkType;\n\n  /**\n   * Create a new HCS-5 base client\n   */\n  constructor(config: HCS5ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      Logger.getInstance({\n        level: config.logLevel || 'info',\n        module: 'HCS5Client',\n        silent: config.silent,\n      });\n\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);\n  }\n}\n"],"names":[],"mappings":";;AAQO,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA,EAQnC,YAAY,QAA0B;AACpC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,OAAO,YAAY;AAAA,MACjB,OAAO,OAAO,YAAY;AAAA,MAC1B,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,IAAA,CAChB;AAEH,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,MAAM;AAAA,EAClE;AACF;"}
+{"version":3,"file":"standards-sdk.es133.js","sources":["../../src/content-store/ContentStoreService.ts"],"sourcesContent":["/**\n * Content Store Service\n *\n * Provides utility functions for content storage and reference handling.\n */\n\nimport type { ContentStoreInterface } from './types';\nimport { Logger } from '../utils/logger';\n\n/**\n * Maximum content size before using references (50KB)\n */\nexport const REFERENCE_THRESHOLD = 50 * 1024;\n\n/**\n * Content store service for managing large content\n */\nexport class ContentStoreServiceImpl {\n  private static _instance: ContentStoreServiceImpl;\n  private contentStore: ContentStoreInterface | null = null;\n  private logger = Logger.getInstance({ module: 'ContentStoreService' });\n\n  static getInstance(): ContentStoreServiceImpl {\n    if (!ContentStoreServiceImpl._instance) {\n      ContentStoreServiceImpl._instance = new ContentStoreServiceImpl();\n    }\n    return ContentStoreServiceImpl._instance;\n  }\n\n  /**\n   * Set the content store instance\n   */\n  async setInstance(store: ContentStoreInterface): Promise<void> {\n    if (this.contentStore) {\n      this.logger.warn('Content store already set, replacing');\n    }\n    this.contentStore = store;\n    this.logger.info('Content store instance set');\n  }\n\n  /**\n   * Get the content store instance\n   */\n  getInstance(): ContentStoreInterface | null {\n    return this.contentStore;\n  }\n\n  /**\n   * Clear the content store instance\n   */\n  dispose(): void {\n    this.contentStore = null;\n    this.logger.info('Content store disposed');\n  }\n\n  /**\n   * Check if content store is available\n   */\n  isAvailable(): boolean {\n    return this.contentStore !== null;\n  }\n}\n\n/**\n * Extract reference ID from input string\n */\nexport function extractReferenceId(input: string): string | null {\n  const trimmed = input.trim();\n\n  const exactMatch = trimmed.match(/^content-ref:([a-f0-9]+)$/);\n  if (exactMatch) {\n    return exactMatch[1];\n  }\n\n  const embeddedMatch = trimmed.match(/content-ref:([a-f0-9]+)/);\n  if (embeddedMatch) {\n    return embeddedMatch[1];\n  }\n\n  return null;\n}\n\n/**\n * Check if content should use reference based on size\n */\nexport function shouldUseReference(content: string | Buffer): boolean {\n  const size =\n    typeof content === 'string'\n      ? Buffer.byteLength(content, 'utf8')\n      : content.length;\n\n  return size > REFERENCE_THRESHOLD;\n}\n\nexport const ContentStoreService = ContentStoreServiceImpl.getInstance();\n"],"names":[],"mappings":";AAYO,MAAM,sBAAsB,KAAK;AAKjC,MAAM,wBAAwB;AAAA,EAA9B,cAAA;AAEL,SAAQ,eAA6C;AACrD,SAAQ,SAAS,OAAO,YAAY,EAAE,QAAQ,uBAAuB;AAAA,EAAA;AAAA,EAErE,OAAO,cAAuC;AAC5C,QAAI,CAAC,wBAAwB,WAAW;AACtC,8BAAwB,YAAY,IAAI,wBAAA;AAAA,IAC1C;AACA,WAAO,wBAAwB;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,OAA6C;AAC7D,QAAI,KAAK,cAAc;AACrB,WAAK,OAAO,KAAK,sCAAsC;AAAA,IACzD;AACA,SAAK,eAAe;AACpB,SAAK,OAAO,KAAK,4BAA4B;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,cAA4C;AAC1C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,SAAK,eAAe;AACpB,SAAK,OAAO,KAAK,wBAAwB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,iBAAiB;AAAA,EAC/B;AACF;AAKO,SAAS,mBAAmB,OAA8B;AAC/D,QAAM,UAAU,MAAM,KAAA;AAEtB,QAAM,aAAa,QAAQ,MAAM,2BAA2B;AAC5D,MAAI,YAAY;AACd,WAAO,WAAW,CAAC;AAAA,EACrB;AAEA,QAAM,gBAAgB,QAAQ,MAAM,yBAAyB;AAC7D,MAAI,eAAe;AACjB,WAAO,cAAc,CAAC;AAAA,EACxB;AAEA,SAAO;AACT;AAKO,SAAS,mBAAmB,SAAmC;AACpE,QAAM,OACJ,OAAO,YAAY,WACf,OAAO,WAAW,SAAS,MAAM,IACjC,QAAQ;AAEd,SAAO,OAAO;AAChB;AAEO,MAAM,sBAAsB,wBAAwB,YAAA;"}

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

@@ -1,59 +1,31 @@
-const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
-const BASE = 58;
-function base58Encode(bytes) {
-  if (bytes.length === 0) return "";
-  let zeros = 0;
-  while (zeros < bytes.length && bytes[zeros] === 0) zeros++;
-  if (zeros === bytes.length) return "1".repeat(zeros);
-  const digits = [0];
-  for (let i = zeros; i < bytes.length; i++) {
-    let carry = bytes[i];
-    for (let j = 0; j < digits.length; j++) {
-      const val = (digits[j] << 8) + carry;
-      digits[j] = val % BASE;
-      carry = val / BASE | 0;
-    }
-    while (carry > 0) {
-      digits.push(carry % BASE);
-      carry = carry / BASE | 0;
-    }
-  }
-  let result = "";
-  for (let i = 0; i < zeros; i++) result += "1";
-  for (let i = digits.length - 1; i >= 0; i--) result += ALPHABET[digits[i]];
-  return result;
-}
-function base58Decode(text) {
-  if (text.length === 0) return new Uint8Array(0);
-  let zeros = 0;
-  while (zeros < text.length && text[zeros] === "1") zeros++;
-  const b256 = [];
-  for (let i = zeros; i < text.length; i++) {
-    const ch = text[i];
-    const val = ALPHABET.indexOf(ch);
-    if (val === -1) throw new Error("Invalid Base58 character");
-    let carry = val;
-    for (let j = 0; j < b256.length; j++) {
-      const x = b256[j] * BASE + carry;
-      b256[j] = x & 255;
-      carry = x >> 8;
-    }
-    while (carry > 0) {
-      b256.push(carry & 255);
-      carry >>= 8;
-    }
-  }
-  for (let i = 0; i < zeros; i++) b256.push(0);
-  b256.reverse();
-  return Uint8Array.from(b256);
-}
-function multibaseB58btcDecode(zText) {
-  if (!zText.startsWith("z")) throw new Error("Invalid multibase base58btc");
-  return base58Decode(zText.slice(1));
-}
+import { CanonicalAgentDataSchema, HCS14_PROTOCOL_REGEX } from "./standards-sdk.es55.js";
+import { canonicalizeAgentData } from "./standards-sdk.es56.js";
+import { createUaid, parseHcs14Did } from "./standards-sdk.es57.js";
+import { isEip155Caip10, isHederaCaip10, isHederaNetwork, parseHederaCaip10, toEip155Caip10, toHederaCaip10 } from "./standards-sdk.es58.js";
+import { ResolverRegistry, defaultResolverRegistry, registerDefaultResolvers } from "./standards-sdk.es59.js";
+import { HieroDidResolver } from "./standards-sdk.es60.js";
+import { HCS14Client } from "./standards-sdk.es61.js";
+import { IssuerRegistry, defaultIssuerRegistry } from "./standards-sdk.es62.js";
+import { HederaHieroIssuer } from "./standards-sdk.es63.js";
 export {
-  base58Decode,
-  base58Encode,
-  multibaseB58btcDecode
+  CanonicalAgentDataSchema,
+  HCS14Client,
+  HCS14_PROTOCOL_REGEX,
+  HederaHieroIssuer,
+  HieroDidResolver,
+  IssuerRegistry,
+  ResolverRegistry,
+  canonicalizeAgentData,
+  createUaid,
+  defaultIssuerRegistry,
+  defaultResolverRegistry,
+  isEip155Caip10,
+  isHederaCaip10,
+  isHederaNetwork,
+  parseHcs14Did,
+  parseHederaCaip10,
+  registerDefaultResolvers,
+  toEip155Caip10,
+  toHederaCaip10
 };
 //# sourceMappingURL=standards-sdk.es134.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es134.js","sources":["../../src/hcs-14/base58.ts"],"sourcesContent":["/**\n * Minimal Base58 encoder/decoder (Bitcoin alphabet) with no external dependencies.\n */\n\nconst ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';\nconst BASE = 58;\n\nfunction countLeadingZeros(bytes: Uint8Array): number {\n  let zeros = 0;\n  for (let i = 0; i < bytes.length && bytes[i] === 0; i++) {\n    zeros++;\n  }\n  return zeros;\n}\n\nexport function base58Encode(bytes: Uint8Array): string {\n  if (bytes.length === 0) return '';\n\n  let zeros = 0;\n  while (zeros < bytes.length && bytes[zeros] === 0) zeros++;\n\n  if (zeros === bytes.length) return '1'.repeat(zeros);\n\n  const digits: number[] = [0];\n  for (let i = zeros; i < bytes.length; i++) {\n    let carry = bytes[i];\n    for (let j = 0; j < digits.length; j++) {\n      const val = (digits[j] << 8) + carry;\n      digits[j] = val % BASE;\n      carry = (val / BASE) | 0;\n    }\n    while (carry > 0) {\n      digits.push(carry % BASE);\n      carry = (carry / BASE) | 0;\n    }\n  }\n\n  let result = '';\n  for (let i = 0; i < zeros; i++) result += '1';\n  for (let i = digits.length - 1; i >= 0; i--) result += ALPHABET[digits[i]];\n  return result;\n}\n\nexport function base58Decode(text: string): Uint8Array {\n  if (text.length === 0) return new Uint8Array(0);\n\n  let zeros = 0;\n  while (zeros < text.length && text[zeros] === '1') zeros++;\n\n  const b256: number[] = [];\n  for (let i = zeros; i < text.length; i++) {\n    const ch = text[i];\n    const val = ALPHABET.indexOf(ch);\n    if (val === -1) throw new Error('Invalid Base58 character');\n\n    let carry = val;\n    for (let j = 0; j < b256.length; j++) {\n      const x = b256[j] * BASE + carry;\n      b256[j] = x & 0xff;\n      carry = x >> 8;\n    }\n    while (carry > 0) {\n      b256.push(carry & 0xff);\n      carry >>= 8;\n    }\n  }\n\n  for (let i = 0; i < zeros; i++) b256.push(0);\n  b256.reverse();\n  return Uint8Array.from(b256);\n}\n\nexport function multibaseB58btcDecode(zText: string): Uint8Array {\n  if (!zText.startsWith('z')) throw new Error('Invalid multibase base58btc');\n  return base58Decode(zText.slice(1));\n}\n"],"names":[],"mappings":"AAIA,MAAM,WAAW;AACjB,MAAM,OAAO;AAUN,SAAS,aAAa,OAA2B;AACtD,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,MAAI,QAAQ;AACZ,SAAO,QAAQ,MAAM,UAAU,MAAM,KAAK,MAAM,EAAG;AAEnD,MAAI,UAAU,MAAM,OAAQ,QAAO,IAAI,OAAO,KAAK;AAEnD,QAAM,SAAmB,CAAC,CAAC;AAC3B,WAAS,IAAI,OAAO,IAAI,MAAM,QAAQ,KAAK;AACzC,QAAI,QAAQ,MAAM,CAAC;AACnB,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,YAAM,OAAO,OAAO,CAAC,KAAK,KAAK;AAC/B,aAAO,CAAC,IAAI,MAAM;AAClB,cAAS,MAAM,OAAQ;AAAA,IACzB;AACA,WAAO,QAAQ,GAAG;AAChB,aAAO,KAAK,QAAQ,IAAI;AACxB,cAAS,QAAQ,OAAQ;AAAA,IAC3B;AAAA,EACF;AAEA,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,OAAO,IAAK,WAAU;AAC1C,WAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,IAAK,WAAU,SAAS,OAAO,CAAC,CAAC;AACzE,SAAO;AACT;AAEO,SAAS,aAAa,MAA0B;AACrD,MAAI,KAAK,WAAW,EAAG,QAAO,IAAI,WAAW,CAAC;AAE9C,MAAI,QAAQ;AACZ,SAAO,QAAQ,KAAK,UAAU,KAAK,KAAK,MAAM,IAAK;AAEnD,QAAM,OAAiB,CAAA;AACvB,WAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,KAAK;AACxC,UAAM,KAAK,KAAK,CAAC;AACjB,UAAM,MAAM,SAAS,QAAQ,EAAE;AAC/B,QAAI,QAAQ,GAAI,OAAM,IAAI,MAAM,0BAA0B;AAE1D,QAAI,QAAQ;AACZ,aAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAM,IAAI,KAAK,CAAC,IAAI,OAAO;AAC3B,WAAK,CAAC,IAAI,IAAI;AACd,cAAQ,KAAK;AAAA,IACf;AACA,WAAO,QAAQ,GAAG;AAChB,WAAK,KAAK,QAAQ,GAAI;AACtB,gBAAU;AAAA,IACZ;AAAA,EACF;AAEA,WAAS,IAAI,GAAG,IAAI,OAAO,IAAK,MAAK,KAAK,CAAC;AAC3C,OAAK,QAAA;AACL,SAAO,WAAW,KAAK,IAAI;AAC7B;AAEO,SAAS,sBAAsB,OAA2B;AAC/D,MAAI,CAAC,MAAM,WAAW,GAAG,EAAG,OAAM,IAAI,MAAM,6BAA6B;AACzE,SAAO,aAAa,MAAM,MAAM,CAAC,CAAC;AACpC;"}
+{"version":3,"file":"standards-sdk.es134.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

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

@@ -1,67 +1,141 @@
-import { isBrowser } from "./standards-sdk.es112.js";
-let nodeRequire;
-function isModuleNotFound(specifier, error) {
-  if (!error || typeof error !== "object") {
-    return false;
+import { AccountId, Client, PrivateKey } from "@hashgraph/sdk";
+import { detectKeyTypeFromString } from "./standards-sdk.es113.js";
+class NodeOperatorResolver {
+  constructor(params) {
+    this.mirror = params.mirrorNode;
+    this.logger = params.logger;
   }
-  const code = Reflect.get(error, "code");
-  const message = Reflect.get(error, "message");
-  const messageText = typeof message === "string" ? message : "";
-  if (typeof code === "string" && code.includes("MODULE_NOT_FOUND")) {
-    return messageText.includes(specifier);
-  }
-  if (messageText) {
-    const lowered = messageText.toLowerCase();
-    if (lowered.includes("cannot find module") || lowered.includes("module not found") || lowered.includes("cannot find package")) {
-      return lowered.includes(specifier.toLowerCase());
+  /**
+   * Best-guess parsing for an operator key without network calls.
+   * - If PrivateKey: returns immediately with provided or fallback type.
+   * - If string with explicitType: parse directly.
+   * - If string without type: detect format; fallback to ECDSA.
+   */
+  bestGuessOperatorKey(operatorKeyInput, explicitType) {
+    if (typeof operatorKeyInput !== "string") {
+      return { keyType: explicitType || "ecdsa", privateKey: operatorKeyInput };
     }
-  }
-  return false;
-}
-async function resolveNodeRequire() {
-  if (nodeRequire !== void 0) {
-    return nodeRequire;
-  }
-  if (isBrowser) {
-    nodeRequire = null;
-    return nodeRequire;
-  }
-  try {
-    const globalObject = typeof global !== "undefined" ? global : globalThis;
-    const req = globalObject.process?.mainModule?.require ?? globalObject.require;
-    nodeRequire = typeof req === "function" && typeof req.resolve === "function" ? req : null;
-  } catch {
-    nodeRequire = null;
-  }
-  return nodeRequire;
-}
-async function dynamicImport(specifier) {
-  try {
-    return await import(specifier);
-  } catch (error) {
-    if (isModuleNotFound(specifier, error)) {
-      return null;
+    if (explicitType) {
+      const pk = explicitType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
+      return { keyType: explicitType, privateKey: pk };
+    }
+    try {
+      const detected = detectKeyTypeFromString(operatorKeyInput);
+      return {
+        keyType: detected.detectedType,
+        privateKey: detected.privateKey
+      };
+    } catch {
+      return {
+        keyType: "ecdsa",
+        privateKey: PrivateKey.fromStringECDSA(operatorKeyInput)
+      };
     }
-    throw error;
   }
-}
-async function optionalImport(specifier) {
-  if (isBrowser) {
-    return dynamicImport(specifier);
+  /**
+   * Resolve an operator key using Mirror Node for key type when possible.
+   * - If PrivateKey: return immediately.
+   * - If explicitType: parse directly.
+   * - Else: query Mirror Node; fallback to local detection.
+   */
+  async resolveOperatorKey(operatorId, operatorKeyInput, explicitType) {
+    if (typeof operatorKeyInput !== "string") {
+      return { keyType: explicitType || "ecdsa", privateKey: operatorKeyInput };
+    }
+    if (explicitType) {
+      const pk = explicitType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
+      return { keyType: explicitType, privateKey: pk };
+    }
+    const account = typeof operatorId === "string" ? operatorId : operatorId.toString();
+    try {
+      const info = await this.mirror.requestAccount(account);
+      const t = info?.key?._type || "";
+      const keyType = t.includes("ED25519") ? "ed25519" : "ecdsa";
+      const privateKey = keyType === "ed25519" ? PrivateKey.fromStringED25519(operatorKeyInput) : PrivateKey.fromStringECDSA(operatorKeyInput);
+      return { keyType, privateKey };
+    } catch {
+      this.logger.warn(
+        "Mirror node key detection failed; using local detection or default ECDSA"
+      );
+      return this.bestGuessOperatorKey(operatorKeyInput);
+    }
   }
-  const requireFn = await resolveNodeRequire();
-  if (requireFn) {
+  /**
+   * Resolve a supply key for the given token using Mirror Node token supply_key._type when possible.
+   */
+  async resolveSupplyKey(tokenId, keyInput, fallbackType, explicitType) {
     try {
-      return requireFn(specifier);
-    } catch (error) {
-      if (!isModuleNotFound(specifier, error)) {
-        throw error;
+      const info = await this.mirror.getTokenInfo(tokenId);
+      const t = info?.supply_key?._type || "";
+      if (typeof keyInput !== "string") {
+        return keyInput;
+      }
+      if (explicitType) {
+        return explicitType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
+      }
+      if (t.includes("ED25519")) {
+        return PrivateKey.fromStringED25519(keyInput);
+      }
+      if (t.includes("ECDSA")) {
+        return PrivateKey.fromStringECDSA(keyInput);
+      }
+      return fallbackType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
+    } catch {
+      if (typeof keyInput !== "string") {
+        return keyInput;
       }
+      if (explicitType) {
+        return explicitType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
+      }
+      return fallbackType === "ed25519" ? PrivateKey.fromStringED25519(keyInput) : PrivateKey.fromStringECDSA(keyInput);
     }
   }
-  return dynamicImport(specifier);
+}
+function createNodeOperatorContext(params) {
+  const operatorId = typeof params.operatorId === "string" ? AccountId.fromString(params.operatorId) : params.operatorId;
+  const client = params.client ? params.client : params.network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
+  const resolver = new NodeOperatorResolver({
+    mirrorNode: params.mirrorNode,
+    logger: params.logger
+  });
+  let currentKeyType;
+  let currentPrivateKey;
+  const guess = resolver.bestGuessOperatorKey(
+    params.operatorKey,
+    params.keyType
+  );
+  currentKeyType = guess.keyType;
+  currentPrivateKey = guess.privateKey;
+  client.setOperator(operatorId.toString(), currentPrivateKey);
+  const initPromise = (async () => {
+    try {
+      const resolved = await resolver.resolveOperatorKey(
+        operatorId,
+        params.operatorKey,
+        params.keyType
+      );
+      currentKeyType = resolved.keyType;
+      currentPrivateKey = resolved.privateKey;
+      client.setOperator(operatorId.toString(), currentPrivateKey);
+    } catch {
+    }
+  })();
+  return {
+    client,
+    operatorId,
+    get operatorKey() {
+      return currentPrivateKey;
+    },
+    get keyType() {
+      return currentKeyType;
+    },
+    ensureInitialized: async () => {
+      await initPromise;
+    }
+  };
 }
 export {
-  optionalImport
+  NodeOperatorResolver,
+  createNodeOperatorContext
 };
 //# sourceMappingURL=standards-sdk.es135.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es135.js","sources":["../../src/utils/dynamic-import.ts"],"sourcesContent":["import { isBrowser } from './is-browser';\n\nlet nodeRequire: NodeRequire | null | undefined;\n\nfunction isModuleNotFound(specifier: string, error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const code = Reflect.get(error, 'code');\n  const message = Reflect.get(error, 'message');\n  const messageText = typeof message === 'string' ? message : '';\n\n  if (typeof code === 'string' && code.includes('MODULE_NOT_FOUND')) {\n    return messageText.includes(specifier);\n  }\n\n  if (messageText) {\n    const lowered = messageText.toLowerCase();\n    if (\n      lowered.includes('cannot find module') ||\n      lowered.includes('module not found') ||\n      lowered.includes('cannot find package')\n    ) {\n      return lowered.includes(specifier.toLowerCase());\n    }\n  }\n\n  return false;\n}\n\nasync function resolveNodeRequire(): Promise<NodeRequire | null> {\n  if (nodeRequire !== undefined) {\n    return nodeRequire;\n  }\n\n  if (isBrowser) {\n    nodeRequire = null;\n    return nodeRequire;\n  }\n\n  try {\n    const globalObject =\n      typeof global !== 'undefined'\n        ? (global as typeof globalThis)\n        : globalThis;\n    const req =\n      globalObject.process?.mainModule?.require ??\n      (globalObject as { require?: NodeRequire }).require;\n\n    nodeRequire =\n      typeof req === 'function' &&\n      typeof (req as NodeRequire).resolve === 'function'\n        ? (req as NodeRequire)\n        : null;\n  } catch {\n    nodeRequire = null;\n  }\n\n  return nodeRequire;\n}\n\nasync function dynamicImport<T>(specifier: string): Promise<T | null> {\n  try {\n    return (await import(specifier)) as T;\n  } catch (error) {\n    if (isModuleNotFound(specifier, error)) {\n      return null;\n    }\n    throw error as Error;\n  }\n}\n\nexport async function optionalImport<T>(specifier: string): Promise<T | null> {\n  if (isBrowser) {\n    return dynamicImport<T>(specifier);\n  }\n\n  const requireFn = await resolveNodeRequire();\n  if (requireFn) {\n    try {\n      return requireFn(specifier) as T;\n    } catch (error) {\n      if (!isModuleNotFound(specifier, error)) {\n        throw error as Error;\n      }\n    }\n  }\n\n  return dynamicImport<T>(specifier);\n}\n"],"names":[],"mappings":";AAEA,IAAI;AAEJ,SAAS,iBAAiB,WAAmB,OAAyB;AACpE,MAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,WAAO;AAAA,EACT;AACA,QAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;AACtC,QAAM,UAAU,QAAQ,IAAI,OAAO,SAAS;AAC5C,QAAM,cAAc,OAAO,YAAY,WAAW,UAAU;AAE5D,MAAI,OAAO,SAAS,YAAY,KAAK,SAAS,kBAAkB,GAAG;AACjE,WAAO,YAAY,SAAS,SAAS;AAAA,EACvC;AAEA,MAAI,aAAa;AACf,UAAM,UAAU,YAAY,YAAA;AAC5B,QACE,QAAQ,SAAS,oBAAoB,KACrC,QAAQ,SAAS,kBAAkB,KACnC,QAAQ,SAAS,qBAAqB,GACtC;AACA,aAAO,QAAQ,SAAS,UAAU,YAAA,CAAa;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AAEA,eAAe,qBAAkD;AAC/D,MAAI,gBAAgB,QAAW;AAC7B,WAAO;AAAA,EACT;AAEA,MAAI,WAAW;AACb,kBAAc;AACd,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,eACJ,OAAO,WAAW,cACb,SACD;AACN,UAAM,MACJ,aAAa,SAAS,YAAY,WACjC,aAA2C;AAE9C,kBACE,OAAO,QAAQ,cACf,OAAQ,IAAoB,YAAY,aACnC,MACD;AAAA,EACR,QAAQ;AACN,kBAAc;AAAA,EAChB;AAEA,SAAO;AACT;AAEA,eAAe,cAAiB,WAAsC;AACpE,MAAI;AACF,WAAQ,MAAM,OAAO;AAAA,EACvB,SAAS,OAAO;AACd,QAAI,iBAAiB,WAAW,KAAK,GAAG;AACtC,aAAO;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;AAEA,eAAsB,eAAkB,WAAsC;AAC5E,MAAI,WAAW;AACb,WAAO,cAAiB,SAAS;AAAA,EACnC;AAEA,QAAM,YAAY,MAAM,mBAAA;AACxB,MAAI,WAAW;AACb,QAAI;AACF,aAAO,UAAU,SAAS;AAAA,IAC5B,SAAS,OAAO;AACd,UAAI,CAAC,iBAAiB,WAAW,KAAK,GAAG;AACvC,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO,cAAiB,SAAS;AACnC;"}
+{"version":3,"file":"standards-sdk.es135.js","sources":["../../src/common/node-operator-resolver.ts"],"sourcesContent":["import { AccountId, Client, PrivateKey } from '@hashgraph/sdk';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { ILogger } from '../utils/logger';\nimport { detectKeyTypeFromString } from '../utils/key-type-detector';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Resolves operator and supply private keys using Mirror Node as source of truth\n * with format-detection fallbacks for string keys.\n */\nexport class NodeOperatorResolver {\n  private readonly mirror: HederaMirrorNode;\n  private readonly logger: ILogger;\n\n  constructor(params: { mirrorNode: HederaMirrorNode; logger: ILogger }) {\n    this.mirror = params.mirrorNode;\n    this.logger = params.logger;\n  }\n\n  /**\n   * Best-guess parsing for an operator key without network calls.\n   * - If PrivateKey: returns immediately with provided or fallback type.\n   * - If string with explicitType: parse directly.\n   * - If string without type: detect format; fallback to ECDSA.\n   */\n  bestGuessOperatorKey(\n    operatorKeyInput: string | PrivateKey,\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): { keyType: 'ed25519' | 'ecdsa'; privateKey: PrivateKey } {\n    if (typeof operatorKeyInput !== 'string') {\n      return { keyType: explicitType || 'ecdsa', privateKey: operatorKeyInput };\n    }\n    if (explicitType) {\n      const pk =\n        explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType: explicitType, privateKey: pk };\n    }\n    try {\n      const detected = detectKeyTypeFromString(operatorKeyInput);\n      return {\n        keyType: detected.detectedType,\n        privateKey: detected.privateKey,\n      };\n    } catch {\n      return {\n        keyType: 'ecdsa',\n        privateKey: PrivateKey.fromStringECDSA(operatorKeyInput),\n      };\n    }\n  }\n\n  /**\n   * Resolve an operator key using Mirror Node for key type when possible.\n   * - If PrivateKey: return immediately.\n   * - If explicitType: parse directly.\n   * - Else: query Mirror Node; fallback to local detection.\n   */\n  async resolveOperatorKey(\n    operatorId: string | AccountId,\n    operatorKeyInput: string | PrivateKey,\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): Promise<{ keyType: 'ed25519' | 'ecdsa'; privateKey: PrivateKey }> {\n    if (typeof operatorKeyInput !== 'string') {\n      return { keyType: explicitType || 'ecdsa', privateKey: operatorKeyInput };\n    }\n    if (explicitType) {\n      const pk =\n        explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType: explicitType, privateKey: pk };\n    }\n    const account =\n      typeof operatorId === 'string' ? operatorId : operatorId.toString();\n    try {\n      const info = await this.mirror.requestAccount(account);\n      const t = info?.key?._type || '';\n      const keyType: 'ed25519' | 'ecdsa' = t.includes('ED25519')\n        ? 'ed25519'\n        : 'ecdsa';\n      const privateKey =\n        keyType === 'ed25519'\n          ? PrivateKey.fromStringED25519(operatorKeyInput)\n          : PrivateKey.fromStringECDSA(operatorKeyInput);\n      return { keyType, privateKey };\n    } catch {\n      this.logger.warn(\n        'Mirror node key detection failed; using local detection or default ECDSA',\n      );\n      return this.bestGuessOperatorKey(operatorKeyInput);\n    }\n  }\n\n  /**\n   * Resolve a supply key for the given token using Mirror Node token supply_key._type when possible.\n   */\n  async resolveSupplyKey(\n    tokenId: string,\n    keyInput: string | PrivateKey,\n    fallbackType: 'ed25519' | 'ecdsa',\n    explicitType?: 'ed25519' | 'ecdsa',\n  ): Promise<PrivateKey> {\n    try {\n      const info = await this.mirror.getTokenInfo(tokenId);\n      const t = info?.supply_key?._type || '';\n      if (typeof keyInput !== 'string') {\n        return keyInput;\n      }\n      if (explicitType) {\n        return explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(keyInput)\n          : PrivateKey.fromStringECDSA(keyInput);\n      }\n      if (t.includes('ED25519')) {\n        return PrivateKey.fromStringED25519(keyInput);\n      }\n      if (t.includes('ECDSA')) {\n        return PrivateKey.fromStringECDSA(keyInput);\n      }\n      return fallbackType === 'ed25519'\n        ? PrivateKey.fromStringED25519(keyInput)\n        : PrivateKey.fromStringECDSA(keyInput);\n    } catch {\n      if (typeof keyInput !== 'string') {\n        return keyInput;\n      }\n      if (explicitType) {\n        return explicitType === 'ed25519'\n          ? PrivateKey.fromStringED25519(keyInput)\n          : PrivateKey.fromStringECDSA(keyInput);\n      }\n      return fallbackType === 'ed25519'\n        ? PrivateKey.fromStringED25519(keyInput)\n        : PrivateKey.fromStringECDSA(keyInput);\n    }\n  }\n}\n\nexport interface NodeOperatorInitParams {\n  network: NetworkType;\n  operatorId: string | AccountId;\n  operatorKey: string | PrivateKey;\n  keyType?: 'ed25519' | 'ecdsa';\n  mirrorNode: HederaMirrorNode;\n  logger: ILogger;\n  client?: Client;\n}\n\nexport interface NodeOperatorContext {\n  client: Client;\n  operatorId: AccountId;\n  readonly operatorKey: PrivateKey;\n  readonly keyType: 'ed25519' | 'ecdsa';\n  ensureInitialized(): Promise<void>;\n}\n\nexport function createNodeOperatorContext(\n  params: NodeOperatorInitParams,\n): NodeOperatorContext {\n  const operatorId: AccountId =\n    typeof params.operatorId === 'string'\n      ? AccountId.fromString(params.operatorId)\n      : params.operatorId;\n\n  const client: Client = params.client\n    ? params.client\n    : params.network === 'mainnet'\n      ? Client.forMainnet()\n      : Client.forTestnet();\n\n  const resolver = new NodeOperatorResolver({\n    mirrorNode: params.mirrorNode,\n    logger: params.logger,\n  });\n\n  let currentKeyType: 'ed25519' | 'ecdsa';\n  let currentPrivateKey: PrivateKey;\n\n  const guess = resolver.bestGuessOperatorKey(\n    params.operatorKey,\n    params.keyType,\n  );\n  currentKeyType = guess.keyType;\n  currentPrivateKey = guess.privateKey;\n  client.setOperator(operatorId.toString(), currentPrivateKey);\n\n  const initPromise = (async () => {\n    try {\n      const resolved = await resolver.resolveOperatorKey(\n        operatorId,\n        params.operatorKey,\n        params.keyType,\n      );\n      currentKeyType = resolved.keyType;\n      currentPrivateKey = resolved.privateKey;\n      client.setOperator(operatorId.toString(), currentPrivateKey);\n    } catch {}\n  })();\n\n  return {\n    client,\n    operatorId,\n    get operatorKey() {\n      return currentPrivateKey;\n    },\n    get keyType() {\n      return currentKeyType;\n    },\n    ensureInitialized: async () => {\n      await initPromise;\n    },\n  };\n}\n"],"names":[],"mappings":"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"}