@hashgraphonline/standards-sdk 0.1.141-canary.24 → 0.1.141-canary.25

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

@@ -1,20 +1,141 @@
-import { Logger } from "./standards-sdk.es106.js";
-import { HederaMirrorNode } from "./standards-sdk.es127.js";
-class HCS5BaseClient {
+import { AccountId, Client, PrivateKey } from "@hashgraph/sdk";
+import { detectKeyTypeFromString } from "./standards-sdk.es114.js";
+class NodeOperatorResolver {
+  constructor(params) {
+    this.mirror = params.mirrorNode;
+    this.logger = params.logger;
+  }
+  /**
+   * 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 };
+    }
+    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)
+      };
+    }
+  }
   /**
-   * Create a new HCS-5 base client
+   * 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.
    */
-  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);
+  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);
+    }
   }
+  /**
+   * Resolve a supply key for the given token using Mirror Node token supply_key._type when possible.
+   */
+  async resolveSupplyKey(tokenId, keyInput, fallbackType, explicitType) {
+    try {
+      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);
+    }
+  }
+}
+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 {
-  HCS5BaseClient
+  NodeOperatorResolver,
+  createNodeOperatorContext
 };
 //# sourceMappingURL=standards-sdk.es139.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es139.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.es139.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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"}