@hashgraphonline/standards-sdk 0.1.137 → 0.1.138

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

@@ -1,141 +1,90 @@
-import { AccountId, Client, PrivateKey } from "@hashgraph/sdk";
-import { detectKeyTypeFromString } from "./standards-sdk.es107.js";
-class NodeOperatorResolver {
-  constructor(params) {
-    this.mirror = params.mirrorNode;
-    this.logger = params.logger;
+const normalise = (value) => value.trim().toLowerCase();
+const HEDERA_NETWORK_ALIASES = /* @__PURE__ */ new Map([
+  ["hedera:mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera-mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera_mainnet", { canonical: "hedera:mainnet", hederaNetwork: "mainnet" }],
+  ["hedera:testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["hedera-testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }],
+  ["hedera_testnet", { canonical: "hedera:testnet", hederaNetwork: "testnet" }]
+]);
+const EVM_NETWORK_CHAIN_IDS = {
+  abstract: 2741,
+  "abstract-testnet": 11124,
+  base: 8453,
+  "base-sepolia": 84532,
+  avalanche: 43114,
+  "avalanche-fuji": 43113,
+  iotex: 4689,
+  sei: 1329,
+  "sei-testnet": 1328,
+  polygon: 137,
+  "polygon-amoy": 80002,
+  peaq: 3338
+};
+const CHAIN_ID_TO_ALIAS = new Map(
+  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias])
+);
+const parseChainId = (value) => {
+  if (/^eip155:\d+$/i.test(value)) {
+    return Number.parseInt(value.split(":")[1], 10);
   }
-  /**
-   * 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)
-      };
-    }
+  if (/^\d+$/.test(value)) {
+    return Number.parseInt(value, 10);
   }
-  /**
-   * 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);
+  return void 0;
+};
+const normaliseEvmNetwork = (value) => {
+  const trimmed = normalise(value);
+  let chainId = parseChainId(trimmed);
+  let alias;
+  if (chainId === void 0) {
+    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];
+    if (mapped !== void 0) {
+      chainId = mapped;
+      alias = trimmed;
     }
+  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {
+    alias = CHAIN_ID_TO_ALIAS.get(chainId);
   }
-  /**
-   * 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);
-    }
+  if (chainId === void 0) {
+    throw new Error(
+      'Unsupported EVM ledger network. Provide an alias like "base-sepolia" or a canonical eip155:<chainId> string.'
+    );
   }
-}
-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;
-    }
+    canonical: `eip155:${chainId}`,
+    kind: "evm",
+    chainId,
+    legacyName: alias
+  };
+};
+const normaliseHederaNetwork = (value) => {
+  const trimmed = normalise(value);
+  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);
+  if (!mapping) {
+    throw new Error(
+      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy "mainnet"/"testnet" also accepted).'
+    );
+  }
+  return {
+    canonical: mapping.canonical,
+    kind: "hedera",
+    hederaNetwork: mapping.hederaNetwork
   };
-}
+};
+const canonicalizeLedgerNetwork = (network) => {
+  if (typeof network !== "string" || network.trim().length === 0) {
+    throw new Error("Ledger network is required.");
+  }
+  const trimmed = normalise(network);
+  if (trimmed.startsWith("hedera:") || trimmed.includes("hedera-") || trimmed.includes("hedera_") || trimmed === "mainnet" || trimmed === "testnet") {
+    return normaliseHederaNetwork(trimmed);
+  }
+  return normaliseEvmNetwork(trimmed);
+};
 export {
-  NodeOperatorResolver,
-  createNodeOperatorContext
+  canonicalizeLedgerNetwork
 };
 //# sourceMappingURL=standards-sdk.es129.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es129.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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"}
+{"version":3,"file":"standards-sdk.es129.js","sources":["../../src/services/registry-broker/ledger-network.ts"],"sourcesContent":["type HederaNetwork = 'mainnet' | 'testnet';\ntype LedgerNetworkKind = 'hedera' | 'evm';\n\nexport interface CanonicalLedgerNetwork {\n  canonical: string;\n  kind: LedgerNetworkKind;\n  hederaNetwork?: HederaNetwork;\n  chainId?: number;\n  legacyName?: string;\n}\n\nconst normalise = (value: string): string => value.trim().toLowerCase();\n\nconst HEDERA_NETWORK_ALIASES = new Map<\n  string,\n  { canonical: `hedera:${HederaNetwork}`; hederaNetwork: HederaNetwork }\n>([\n  ['hedera:mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera-mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera_mainnet', { canonical: 'hedera:mainnet', hederaNetwork: 'mainnet' }],\n  ['hedera:testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera-testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n  ['hedera_testnet', { canonical: 'hedera:testnet', hederaNetwork: 'testnet' }],\n]);\n\nconst EVM_NETWORK_CHAIN_IDS: Record<string, number> = {\n  abstract: 2741,\n  'abstract-testnet': 11124,\n  base: 8453,\n  'base-sepolia': 84532,\n  avalanche: 43114,\n  'avalanche-fuji': 43113,\n  iotex: 4689,\n  sei: 1329,\n  'sei-testnet': 1328,\n  polygon: 137,\n  'polygon-amoy': 80002,\n  peaq: 3338,\n};\n\nconst CHAIN_ID_TO_ALIAS = new Map<number, string>(\n  Object.entries(EVM_NETWORK_CHAIN_IDS).map(([alias, id]) => [id, alias]),\n);\n\nconst parseChainId = (value: string): number | undefined => {\n  if (/^eip155:\\d+$/i.test(value)) {\n    return Number.parseInt(value.split(':')[1]!, 10);\n  }\n  if (/^\\d+$/.test(value)) {\n    return Number.parseInt(value, 10);\n  }\n  return undefined;\n};\n\nconst normaliseEvmNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  let chainId = parseChainId(trimmed);\n  let alias: string | undefined;\n\n  if (chainId === undefined) {\n    const mapped = EVM_NETWORK_CHAIN_IDS[trimmed];\n    if (mapped !== undefined) {\n      chainId = mapped;\n      alias = trimmed;\n    }\n  } else if (CHAIN_ID_TO_ALIAS.has(chainId)) {\n    alias = CHAIN_ID_TO_ALIAS.get(chainId);\n  }\n\n  if (chainId === undefined) {\n    throw new Error(\n      'Unsupported EVM ledger network. Provide an alias like \"base-sepolia\" or a canonical eip155:<chainId> string.',\n    );\n  }\n\n  return {\n    canonical: `eip155:${chainId}`,\n    kind: 'evm',\n    chainId,\n    legacyName: alias,\n  };\n};\n\nconst normaliseHederaNetwork = (value: string): CanonicalLedgerNetwork => {\n  const trimmed = normalise(value);\n  const mapping = HEDERA_NETWORK_ALIASES.get(trimmed);\n  if (!mapping) {\n    throw new Error(\n      'Unsupported Hedera network. Use hedera:mainnet or hedera:testnet (legacy \"mainnet\"/\"testnet\" also accepted).',\n    );\n  }\n  return {\n    canonical: mapping.canonical,\n    kind: 'hedera',\n    hederaNetwork: mapping.hederaNetwork,\n  };\n};\n\nexport const canonicalizeLedgerNetwork = (\n  network: string,\n): CanonicalLedgerNetwork => {\n  if (typeof network !== 'string' || network.trim().length === 0) {\n    throw new Error('Ledger network is required.');\n  }\n  const trimmed = normalise(network);\n  if (\n    trimmed.startsWith('hedera:') ||\n    trimmed.includes('hedera-') ||\n    trimmed.includes('hedera_') ||\n    trimmed === 'mainnet' ||\n    trimmed === 'testnet'\n  ) {\n    return normaliseHederaNetwork(trimmed);\n  }\n  return normaliseEvmNetwork(trimmed);\n};\n"],"names":[],"mappings":"AAWA,MAAM,YAAY,CAAC,UAA0B,MAAM,KAAA,EAAO,YAAA;AAE1D,MAAM,6CAA6B,IAGjC;AAAA,EACA,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,WAAW,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EACrE,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAAA,EAC5E,CAAC,kBAAkB,EAAE,WAAW,kBAAkB,eAAe,WAAW;AAC9E,CAAC;AAED,MAAM,wBAAgD;AAAA,EACpD,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,KAAK;AAAA,EACL,eAAe;AAAA,EACf,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,MAAM;AACR;AAEA,MAAM,oBAAoB,IAAI;AAAA,EAC5B,OAAO,QAAQ,qBAAqB,EAAE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC;AACxE;AAEA,MAAM,eAAe,CAAC,UAAsC;AAC1D,MAAI,gBAAgB,KAAK,KAAK,GAAG;AAC/B,WAAO,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE,CAAC,GAAI,EAAE;AAAA,EACjD;AACA,MAAI,QAAQ,KAAK,KAAK,GAAG;AACvB,WAAO,OAAO,SAAS,OAAO,EAAE;AAAA,EAClC;AACA,SAAO;AACT;AAEA,MAAM,sBAAsB,CAAC,UAA0C;AACrE,QAAM,UAAU,UAAU,KAAK;AAC/B,MAAI,UAAU,aAAa,OAAO;AAClC,MAAI;AAEJ,MAAI,YAAY,QAAW;AACzB,UAAM,SAAS,sBAAsB,OAAO;AAC5C,QAAI,WAAW,QAAW;AACxB,gBAAU;AACV,cAAQ;AAAA,IACV;AAAA,EACF,WAAW,kBAAkB,IAAI,OAAO,GAAG;AACzC,YAAQ,kBAAkB,IAAI,OAAO;AAAA,EACvC;AAEA,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AAAA,IACL,WAAW,UAAU,OAAO;AAAA,IAC5B,MAAM;AAAA,IACN;AAAA,IACA,YAAY;AAAA,EAAA;AAEhB;AAEA,MAAM,yBAAyB,CAAC,UAA0C;AACxE,QAAM,UAAU,UAAU,KAAK;AAC/B,QAAM,UAAU,uBAAuB,IAAI,OAAO;AAClD,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AAAA,IACL,WAAW,QAAQ;AAAA,IACnB,MAAM;AAAA,IACN,eAAe,QAAQ;AAAA,EAAA;AAE3B;AAEO,MAAM,4BAA4B,CACvC,YAC2B;AAC3B,MAAI,OAAO,YAAY,YAAY,QAAQ,KAAA,EAAO,WAAW,GAAG;AAC9D,UAAM,IAAI,MAAM,6BAA6B;AAAA,EAC/C;AACA,QAAM,UAAU,UAAU,OAAO;AACjC,MACE,QAAQ,WAAW,SAAS,KAC5B,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,SAAS,KAC1B,YAAY,aACZ,YAAY,WACZ;AACA,WAAO,uBAAuB,OAAO;AAAA,EACvC;AACA,SAAO,oBAAoB,OAAO;AACpC;"}

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

@@ -1,4 +1,4 @@
-import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es130.js";
+import { buildTopicCreateTx, buildMessageTx } from "./standards-sdk.es136.js";
 import { HCS7ConfigType, HCS7Operation } from "./standards-sdk.es9.js";
 function buildHcs7CreateRegistryTx(params) {
   const memo = `hcs-7:indexed:${params.ttl}`;

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

@@ -1,45 +1,162 @@
-import { TopicMessageSubmitTransaction, TopicId, TopicCreateTransaction, PublicKey, KeyList } from "@hashgraph/sdk";
-function encodeHcs2RegistryMemo(indexedFlag, ttl) {
-  return `hcs-2:${indexedFlag}:${ttl}`;
-}
-function buildTopicCreateTx(params) {
-  const { memo, adminKey, submitKey, operatorPublicKey } = params;
-  const tx = new TopicCreateTransaction().setTopicMemo(memo);
-  const coerceKey = (k) => {
-    if (!k) return void 0;
-    if (k instanceof PublicKey || k instanceof KeyList) return k;
-    if (typeof k === "boolean") {
-      return k ? operatorPublicKey : void 0;
+import { CustomFeeType } from "./standards-sdk.es131.js";
+import { HederaMirrorNode } from "./standards-sdk.es126.js";
+class FeeConfigBuilder {
+  constructor(options) {
+    this.customFees = [];
+    this.logger = options.logger;
+    this.mirrorNode = new HederaMirrorNode(options.network, options.logger);
+    this.defaultCollectorAccountId = options.defaultCollectorAccountId || "";
+  }
+  /**
+   * Static factory method to create a FeeConfigBuilder with a single HBAR fee.
+   * @param hbarAmount Amount in HBAR.
+   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
+   * @param network Network type ('mainnet' or 'testnet').
+   * @param logger Logger instance.
+   * @param exemptAccounts Optional array of account IDs exempt from this fee.
+   * @returns A configured FeeConfigBuilder instance.
+   */
+  static forHbar(hbarAmount, collectorAccountId, network, logger, exemptAccounts = []) {
+    const builder = new FeeConfigBuilder({
+      network,
+      logger,
+      defaultCollectorAccountId: collectorAccountId
+    });
+    return builder.addHbarFee(hbarAmount, collectorAccountId, exemptAccounts);
+  }
+  /**
+   * Static factory method to create a FeeConfigBuilder with a single token fee.
+   * Automatically fetches token decimals if not provided.
+   * @param tokenAmount Amount of tokens.
+   * @param feeTokenId Token ID for the fee.
+   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.
+   * @param network Network type ('mainnet' or 'testnet').
+   * @param logger Logger instance.
+   * @param exemptAccounts Optional array of account IDs exempt from this fee.
+   * @param decimals Optional decimals for the token (fetched if omitted).
+   * @returns A Promise resolving to a configured FeeConfigBuilder instance.
+   */
+  static async forToken(tokenAmount, feeTokenId, collectorAccountId, network, logger, exemptAccounts = [], decimals) {
+    const builder = new FeeConfigBuilder({
+      network,
+      logger,
+      defaultCollectorAccountId: collectorAccountId
+    });
+    await builder.addTokenFee(
+      tokenAmount,
+      feeTokenId,
+      collectorAccountId,
+      decimals,
+      exemptAccounts
+    );
+    return builder;
+  }
+  /**
+   * Adds an HBAR fee configuration to the builder.
+   * Allows chaining multiple fee additions.
+   * @param hbarAmount The amount in HBAR (e.g., 0.5).
+   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
+   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.
+   * @returns This FeeConfigBuilder instance for chaining.
+   */
+  addHbarFee(hbarAmount, collectorAccountId, exemptAccountIds = []) {
+    if (hbarAmount <= 0) {
+      throw new Error("HBAR amount must be greater than zero");
+    }
+    this.customFees.push({
+      feeAmount: {
+        amount: hbarAmount * 1e8,
+        decimals: 0
+      },
+      feeCollectorAccountId: collectorAccountId || this.defaultCollectorAccountId,
+      feeTokenId: void 0,
+      exemptAccounts: [...exemptAccountIds],
+      type: CustomFeeType.FIXED_FEE
+    });
+    return this;
+  }
+  /**
+   * Adds a token fee configuration to the builder.
+   * Allows chaining multiple fee additions.
+   * Fetches token decimals automatically if not provided.
+   * @param tokenAmount The amount of the specified token.
+   * @param feeTokenId The ID of the token to charge the fee in.
+   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.
+   * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.
+   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.
+   * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.
+   */
+  async addTokenFee(tokenAmount, feeTokenId, collectorAccountId, decimals, exemptAccountIds = []) {
+    if (tokenAmount <= 0) {
+      throw new Error("Token amount must be greater than zero");
     }
-    if (typeof k === "string") {
+    if (!feeTokenId) {
+      throw new Error("Fee token ID is required when adding a token fee");
+    }
+    let finalDecimals = decimals;
+    if (finalDecimals === void 0) {
       try {
-        return PublicKey.fromString(k);
-      } catch {
-        return void 0;
+        const tokenInfo = await this.mirrorNode.getTokenInfo(feeTokenId);
+        if (tokenInfo?.decimals) {
+          finalDecimals = parseInt(tokenInfo.decimals, 10);
+          this.logger.info(
+            `Fetched decimals for ${feeTokenId}: ${finalDecimals}`
+          );
+        } else {
+          this.logger.warn(
+            `Could not fetch decimals for ${feeTokenId}, defaulting to 0.`
+          );
+          finalDecimals = 0;
+        }
+      } catch (error) {
+        this.logger.error(
+          `Error fetching decimals for ${feeTokenId}, defaulting to 0: ${error}`
+        );
+        finalDecimals = 0;
       }
     }
-    return void 0;
-  };
-  const admin = coerceKey(adminKey);
-  if (admin) {
-    tx.setAdminKey(admin);
-  }
-  const submit = coerceKey(submitKey);
-  if (submit) {
-    tx.setSubmitKey(submit);
+    this.customFees.push({
+      feeAmount: {
+        amount: tokenAmount * 10 ** finalDecimals,
+        decimals: finalDecimals
+      },
+      feeCollectorAccountId: collectorAccountId || this.defaultCollectorAccountId,
+      feeTokenId,
+      exemptAccounts: [...exemptAccountIds],
+      type: CustomFeeType.FIXED_FEE
+    });
+    return this;
   }
-  return tx;
-}
-function buildMessageTx(params) {
-  const tx = new TopicMessageSubmitTransaction().setTopicId(TopicId.fromString(params.topicId)).setMessage(params.message);
-  if (params.transactionMemo) {
-    tx.setTransactionMemo(params.transactionMemo);
+  /**
+   * Builds the final TopicFeeConfig object.
+   * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.
+   * @throws Error if no fees have been added.
+   * @throws Error if more than 10 fees have been added.
+   */
+  build() {
+    if (this.customFees.length === 0) {
+      throw new Error(
+        "At least one fee must be added using addHbarFee/addTokenFee or created using forHbar/forToken"
+      );
+    }
+    if (this.customFees.length > 10) {
+      throw new Error("Maximum of 10 custom fees per topic allowed");
+    }
+    const allExemptAccounts = /* @__PURE__ */ new Set();
+    this.customFees.forEach((fee) => {
+      fee.exemptAccounts.forEach((account) => allExemptAccounts.add(account));
+    });
+    const resolvedCustomFees = this.customFees.map((fee) => ({
+      ...fee,
+      feeCollectorAccountId: fee.feeCollectorAccountId || this.defaultCollectorAccountId
+    }));
+    return {
+      customFees: resolvedCustomFees,
+      exemptAccounts: Array.from(allExemptAccounts)
+    };
   }
-  return tx;
 }
 export {
-  buildMessageTx,
-  buildTopicCreateTx,
-  encodeHcs2RegistryMemo
+  FeeConfigBuilder
 };
 //# sourceMappingURL=standards-sdk.es130.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es130.js","sources":["../../src/common/tx/tx-utils.ts"],"sourcesContent":["import {\n  TopicCreateTransaction,\n  TopicMessageSubmitTransaction,\n  PublicKey,\n  KeyList,\n  TopicId,\n} from '@hashgraph/sdk';\n\nexport type MaybeKey = boolean | string | PublicKey | KeyList | undefined;\n\nexport function encodeHcs2RegistryMemo(\n  indexedFlag: 0 | 1,\n  ttl: number,\n): string {\n  return `hcs-2:${indexedFlag}:${ttl}`;\n}\n\nexport function buildTopicCreateTx(params: {\n  memo: string;\n  adminKey?: MaybeKey;\n  submitKey?: MaybeKey;\n  operatorPublicKey?: PublicKey;\n}): TopicCreateTransaction {\n  const { memo, adminKey, submitKey, operatorPublicKey } = params;\n  const tx = new TopicCreateTransaction().setTopicMemo(memo);\n\n  const coerceKey = (k?: MaybeKey): PublicKey | KeyList | undefined => {\n    if (!k) return undefined;\n    if (k instanceof PublicKey || k instanceof KeyList) return k;\n    if (typeof k === 'boolean') {\n      return k ? operatorPublicKey : undefined;\n    }\n    if (typeof k === 'string') {\n      try {\n        return PublicKey.fromString(k);\n      } catch {\n        return undefined;\n      }\n    }\n    return undefined;\n  };\n\n  const admin = coerceKey(adminKey);\n  if (admin) {\n    tx.setAdminKey(admin);\n  }\n\n  const submit = coerceKey(submitKey);\n  if (submit) {\n    tx.setSubmitKey(submit);\n  }\n\n  return tx;\n}\n\nexport function buildMessageTx(params: {\n  topicId: string;\n  message: string | Uint8Array;\n  transactionMemo?: string;\n}): TopicMessageSubmitTransaction {\n  const tx = new TopicMessageSubmitTransaction()\n    .setTopicId(TopicId.fromString(params.topicId))\n    .setMessage(params.message);\n  if (params.transactionMemo) {\n    tx.setTransactionMemo(params.transactionMemo);\n  }\n  return tx;\n}\n"],"names":[],"mappings":";AAUO,SAAS,uBACd,aACA,KACQ;AACR,SAAO,SAAS,WAAW,IAAI,GAAG;AACpC;AAEO,SAAS,mBAAmB,QAKR;AACzB,QAAM,EAAE,MAAM,UAAU,WAAW,sBAAsB;AACzD,QAAM,KAAK,IAAI,yBAAyB,aAAa,IAAI;AAEzD,QAAM,YAAY,CAAC,MAAkD;AACnE,QAAI,CAAC,EAAG,QAAO;AACf,QAAI,aAAa,aAAa,aAAa,QAAS,QAAO;AAC3D,QAAI,OAAO,MAAM,WAAW;AAC1B,aAAO,IAAI,oBAAoB;AAAA,IACjC;AACA,QAAI,OAAO,MAAM,UAAU;AACzB,UAAI;AACF,eAAO,UAAU,WAAW,CAAC;AAAA,MAC/B,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,UAAU,QAAQ;AAChC,MAAI,OAAO;AACT,OAAG,YAAY,KAAK;AAAA,EACtB;AAEA,QAAM,SAAS,UAAU,SAAS;AAClC,MAAI,QAAQ;AACV,OAAG,aAAa,MAAM;AAAA,EACxB;AAEA,SAAO;AACT;AAEO,SAAS,eAAe,QAIG;AAChC,QAAM,KAAK,IAAI,gCACZ,WAAW,QAAQ,WAAW,OAAO,OAAO,CAAC,EAC7C,WAAW,OAAO,OAAO;AAC5B,MAAI,OAAO,iBAAiB;AAC1B,OAAG,mBAAmB,OAAO,eAAe;AAAA,EAC9C;AACA,SAAO;AACT;"}
+{"version":3,"file":"standards-sdk.es130.js","sources":["../../src/fees/fee-config-builder.ts"],"sourcesContent":["import {\n  FeeConfigBuilderInterface,\n  TokenFeeConfig,\n  TopicFeeConfig,\n  CustomFeeType,\n} from './types';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * FeeConfigBuilder provides a fluent interface for creating fee configurations\n * for HCS-10 topics. This makes it easy to configure fees without dealing with\n * the complexity of the underlying fee structure.\n *\n * Example usage:\n *\n * // Super simple one-liner with the factory method\n * const simpleFeeConfig = FeeConfigBuilder.forHbar(5, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']);\n *\n * // With multiple fees:\n * const multipleFeeConfig = new FeeConfigBuilder({\n *   network: NetworkType.TESTNET,\n *   logger: new Logger(),\n *   defaultCollectorAccountId: '0.0.12345',\n *   defaultExemptAccountIds: ['0.0.67890']\n * })\n *   .withHbarFee(1) // 1 HBAR fee\n *   .withTokenFee(10, '0.0.54321') // 10 units of token 0.0.54321\n *   .build();\n *\n * With Agent Builder\n * const agent = new AgentBuilder()\n *   .setName('Fee Collector Agent')\n *   .setDescription('An agent that collects fees')\n *   .setInboundTopicType(InboundTopicType.FEE_BASED)\n *   .setFeeConfig(FeeConfigBuilder.forHbar(1, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']))\n *   .setNetwork('testnet')\n  .build();\n\n * Directly with client\n * const client = new HCS10Client(config);\n * const connectionFeeConfig = new FeeConfigBuilder({\n *   network: NetworkType.TESTNET,\n *   logger: new Logger(),\n *   defaultCollectorAccountId: client.getAccountAndSigner().accountId,\n *   defaultExemptAccountIds: ['0.0.67890']\n * })\n *   .withHbarFee(0.5) // 0.5 HBAR (simple!)\n *   .build();\n\n * const result = await client.handleConnectionRequest(\n *   inboundTopicId,\n *   requestingAccountId,\n *   connectionRequestId,\n *   connectionFeeConfig\n * );\n*/\nexport interface FeeConfigBuilderOptions {\n  network: NetworkType;\n  logger: Logger;\n  defaultCollectorAccountId?: string;\n}\n\nexport class FeeConfigBuilder implements FeeConfigBuilderInterface {\n  private customFees: TokenFeeConfig[] = [];\n  private mirrorNode: HederaMirrorNode;\n  private logger: Logger;\n  private defaultCollectorAccountId: string;\n\n  constructor(options: FeeConfigBuilderOptions) {\n    this.logger = options.logger;\n    this.mirrorNode = new HederaMirrorNode(options.network, options.logger);\n    this.defaultCollectorAccountId = options.defaultCollectorAccountId || '';\n  }\n\n  /**\n   * Static factory method to create a FeeConfigBuilder with a single HBAR fee.\n   * @param hbarAmount Amount in HBAR.\n   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n   * @param network Network type ('mainnet' or 'testnet').\n   * @param logger Logger instance.\n   * @param exemptAccounts Optional array of account IDs exempt from this fee.\n   * @returns A configured FeeConfigBuilder instance.\n   */\n  static forHbar(\n    hbarAmount: number,\n    collectorAccountId: string | undefined,\n    network: NetworkType,\n    logger: Logger,\n    exemptAccounts: string[] = [],\n  ): FeeConfigBuilder {\n    const builder = new FeeConfigBuilder({\n      network,\n      logger,\n      defaultCollectorAccountId: collectorAccountId,\n    });\n    return builder.addHbarFee(hbarAmount, collectorAccountId, exemptAccounts);\n  }\n\n  /**\n   * Static factory method to create a FeeConfigBuilder with a single token fee.\n   * Automatically fetches token decimals if not provided.\n   * @param tokenAmount Amount of tokens.\n   * @param feeTokenId Token ID for the fee.\n   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n   * @param network Network type ('mainnet' or 'testnet').\n   * @param logger Logger instance.\n   * @param exemptAccounts Optional array of account IDs exempt from this fee.\n   * @param decimals Optional decimals for the token (fetched if omitted).\n   * @returns A Promise resolving to a configured FeeConfigBuilder instance.\n   */\n  static async forToken(\n    tokenAmount: number,\n    feeTokenId: string,\n    collectorAccountId: string | undefined,\n    network: NetworkType,\n    logger: Logger,\n    exemptAccounts: string[] = [],\n    decimals?: number,\n  ): Promise<FeeConfigBuilder> {\n    const builder = new FeeConfigBuilder({\n      network,\n      logger,\n      defaultCollectorAccountId: collectorAccountId,\n    });\n    await builder.addTokenFee(\n      tokenAmount,\n      feeTokenId,\n      collectorAccountId,\n      decimals,\n      exemptAccounts,\n    );\n    return builder;\n  }\n\n  /**\n   * Adds an HBAR fee configuration to the builder.\n   * Allows chaining multiple fee additions.\n   * @param hbarAmount The amount in HBAR (e.g., 0.5).\n   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.\n   * @returns This FeeConfigBuilder instance for chaining.\n   */\n  addHbarFee(\n    hbarAmount: number,\n    collectorAccountId?: string,\n    exemptAccountIds: string[] = [],\n  ): FeeConfigBuilder {\n    if (hbarAmount <= 0) {\n      throw new Error('HBAR amount must be greater than zero');\n    }\n\n    this.customFees.push({\n      feeAmount: {\n        amount: hbarAmount * 100_000_000,\n        decimals: 0,\n      },\n      feeCollectorAccountId:\n        collectorAccountId || this.defaultCollectorAccountId,\n      feeTokenId: undefined,\n      exemptAccounts: [...exemptAccountIds],\n      type: CustomFeeType.FIXED_FEE,\n    });\n\n    return this;\n  }\n\n  /**\n   * Adds a token fee configuration to the builder.\n   * Allows chaining multiple fee additions.\n   * Fetches token decimals automatically if not provided.\n   * @param tokenAmount The amount of the specified token.\n   * @param feeTokenId The ID of the token to charge the fee in.\n   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n   * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.\n   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.\n   * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.\n   */\n  async addTokenFee(\n    tokenAmount: number,\n    feeTokenId: string,\n    collectorAccountId?: string,\n    decimals?: number,\n    exemptAccountIds: string[] = [],\n  ): Promise<FeeConfigBuilder> {\n    if (tokenAmount <= 0) {\n      throw new Error('Token amount must be greater than zero');\n    }\n    if (!feeTokenId) {\n      throw new Error('Fee token ID is required when adding a token fee');\n    }\n\n    let finalDecimals = decimals;\n    if (finalDecimals === undefined) {\n      try {\n        const tokenInfo = await this.mirrorNode.getTokenInfo(feeTokenId);\n        if (tokenInfo?.decimals) {\n          finalDecimals = parseInt(tokenInfo.decimals, 10);\n          this.logger.info(\n            `Fetched decimals for ${feeTokenId}: ${finalDecimals}`,\n          );\n        } else {\n          this.logger.warn(\n            `Could not fetch decimals for ${feeTokenId}, defaulting to 0.`,\n          );\n          finalDecimals = 0;\n        }\n      } catch (error) {\n        this.logger.error(\n          `Error fetching decimals for ${feeTokenId}, defaulting to 0: ${error}`,\n        );\n        finalDecimals = 0;\n      }\n    }\n\n    this.customFees.push({\n      feeAmount: {\n        amount: tokenAmount * 10 ** finalDecimals,\n        decimals: finalDecimals,\n      },\n      feeCollectorAccountId:\n        collectorAccountId || this.defaultCollectorAccountId,\n      feeTokenId: feeTokenId,\n      exemptAccounts: [...exemptAccountIds],\n      type: CustomFeeType.FIXED_FEE,\n    });\n\n    return this;\n  }\n\n  /**\n   * Builds the final TopicFeeConfig object.\n   * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.\n   * @throws Error if no fees have been added.\n   * @throws Error if more than 10 fees have been added.\n   */\n  build(): TopicFeeConfig {\n    if (this.customFees.length === 0) {\n      throw new Error(\n        'At least one fee must be added using addHbarFee/addTokenFee or created using forHbar/forToken',\n      );\n    }\n\n    if (this.customFees.length > 10) {\n      throw new Error('Maximum of 10 custom fees per topic allowed');\n    }\n\n    const allExemptAccounts = new Set<string>();\n    this.customFees.forEach(fee => {\n      fee.exemptAccounts.forEach(account => allExemptAccounts.add(account));\n    });\n\n    const resolvedCustomFees = this.customFees.map(fee => ({\n      ...fee,\n      feeCollectorAccountId:\n        fee.feeCollectorAccountId || this.defaultCollectorAccountId,\n    }));\n\n    return {\n      customFees: resolvedCustomFees,\n      exemptAccounts: Array.from(allExemptAccounts),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,20 +1,10 @@
-import { Logger } from "./standards-sdk.es99.js";
-import { HederaMirrorNode } from "./standards-sdk.es120.js";
-class HCS5BaseClient {
-  /**
-   * Create a new HCS-5 base client
-   */
-  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);
-  }
-}
+var CustomFeeType = /* @__PURE__ */ ((CustomFeeType2) => {
+  CustomFeeType2["FIXED_FEE"] = "FIXED_FEE";
+  CustomFeeType2["FRACTIONAL_FEE"] = "FRACTIONAL_FEE";
+  CustomFeeType2["ROYALTY_FEE"] = "ROYALTY_FEE";
+  return CustomFeeType2;
+})(CustomFeeType || {});
 export {
-  HCS5BaseClient
+  CustomFeeType
 };
 //# sourceMappingURL=standards-sdk.es131.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es131.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.es131.js","sources":["../../src/fees/types.ts"],"sourcesContent":["export interface FeeConfigBuilderInterface {\n  addHbarFee(\n    hbarAmount: number,\n    collectorAccountId?: string,\n    exemptAccountIds?: string[],\n  ): FeeConfigBuilderInterface;\n  addTokenFee(\n    tokenAmount: number,\n    feeTokenId: string,\n    collectorAccountId?: string,\n    decimals?: number,\n    exemptAccountIds?: string[],\n  ): Promise<FeeConfigBuilderInterface>;\n  build(): TopicFeeConfig;\n}\n\nexport enum CustomFeeType {\n  FIXED_FEE = 'FIXED_FEE',\n  FRACTIONAL_FEE = 'FRACTIONAL_FEE',\n  ROYALTY_FEE = 'ROYALTY_FEE',\n}\n\nexport type FeeAmount = {\n  amount: number;\n  decimals?: number;\n};\n\nexport interface TokenFeeConfig {\n  feeAmount: FeeAmount;\n  feeCollectorAccountId: string;\n  feeTokenId?: string;\n  exemptAccounts: string[];\n  type: CustomFeeType;\n}\n\nexport interface TopicFeeConfig {\n  customFees: TokenFeeConfig[];\n  exemptAccounts: string[];\n}\n"],"names":["CustomFeeType"],"mappings":"AAgBO,IAAK,kCAAAA,mBAAL;AACLA,iBAAA,WAAA,IAAY;AACZA,iBAAA,gBAAA,IAAiB;AACjBA,iBAAA,aAAA,IAAc;AAHJ,SAAAA;AAAA,GAAA,iBAAA,CAAA,CAAA;"}