@hashgraphonline/standards-sdk 0.1.141-canary.3 → 0.1.141-canary.30

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

@@ -1,162 +1,90 @@
-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 || "";
+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);
+  }
+  if (/^\d+$/.test(value)) {
+    return Number.parseInt(value, 10);
   }
-  /**
-   * 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);
+  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);
   }
-  /**
-   * 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
+  if (chainId === void 0) {
+    throw new Error(
+      'Unsupported EVM ledger network. Provide an alias like "base-sepolia" or a canonical eip155:<chainId> string.'
     );
-    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;
+  return {
+    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).'
+    );
   }
-  /**
-   * 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 (!feeTokenId) {
-      throw new Error("Fee token ID is required when adding a token fee");
-    }
-    let finalDecimals = decimals;
-    if (finalDecimals === void 0) {
-      try {
-        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;
-      }
-    }
-    this.customFees.push({
-      feeAmount: {
-        amount: tokenAmount * 10 ** finalDecimals,
-        decimals: finalDecimals
-      },
-      feeCollectorAccountId: collectorAccountId || this.defaultCollectorAccountId,
-      feeTokenId,
-      exemptAccounts: [...exemptAccountIds],
-      type: CustomFeeType.FIXED_FEE
-    });
-    return this;
+  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.");
   }
-  /**
-   * 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)
-    };
+  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 {
-  FeeConfigBuilder
+  canonicalizeLedgerNetwork
 };
 //# 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/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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"}
+{"version":3,"file":"standards-sdk.es130.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.es131.js

@@ -1,10 +1,162 @@
-var CustomFeeType = /* @__PURE__ */ ((CustomFeeType2) => {
-  CustomFeeType2["FIXED_FEE"] = "FIXED_FEE";
-  CustomFeeType2["FRACTIONAL_FEE"] = "FRACTIONAL_FEE";
-  CustomFeeType2["ROYALTY_FEE"] = "ROYALTY_FEE";
-  return CustomFeeType2;
-})(CustomFeeType || {});
+import { CustomFeeType } from "./standards-sdk.es132.js";
+import { HederaMirrorNode } from "./standards-sdk.es127.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 (!feeTokenId) {
+      throw new Error("Fee token ID is required when adding a token fee");
+    }
+    let finalDecimals = decimals;
+    if (finalDecimals === void 0) {
+      try {
+        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;
+      }
+    }
+    this.customFees.push({
+      feeAmount: {
+        amount: tokenAmount * 10 ** finalDecimals,
+        decimals: finalDecimals
+      },
+      feeCollectorAccountId: collectorAccountId || this.defaultCollectorAccountId,
+      feeTokenId,
+      exemptAccounts: [...exemptAccountIds],
+      type: CustomFeeType.FIXED_FEE
+    });
+    return this;
+  }
+  /**
+   * 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)
+    };
+  }
+}
 export {
-  CustomFeeType
+  FeeConfigBuilder
 };
 //# 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/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;"}
+{"version":3,"file":"standards-sdk.es131.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.es132.js

@@ -1,89 +1,10 @@
-import { Logger } from "./standards-sdk.es105.js";
-class ContentResolverRegistryImpl {
-  constructor() {
-    this.resolver = null;
-    this.onUnavailableCallbacks = [];
-    this.logger = Logger.getInstance({ module: "ContentResolverRegistry" });
-  }
-  static getInstance() {
-    if (!ContentResolverRegistryImpl._instance) {
-      ContentResolverRegistryImpl._instance = new ContentResolverRegistryImpl();
-    }
-    return ContentResolverRegistryImpl._instance;
-  }
-  /**
-   * Register a content resolver (typically called by ContentStoreManager)
-   */
-  register(resolver) {
-    if (this.resolver) {
-      this.logger.warn("Resolver already registered, replacing existing");
-    }
-    this.resolver = resolver;
-    this.logger.info("Content resolver registered");
-  }
-  /**
-   * Get the registered content resolver
-   */
-  getResolver() {
-    return this.resolver;
-  }
-  /**
-   * Check if a resolver is available
-   */
-  isAvailable() {
-    return this.resolver !== null;
-  }
-  /**
-   * Unregister the current resolver
-   */
-  unregister() {
-    if (this.resolver) {
-      this.resolver = null;
-      this.logger.info("Content resolver unregistered");
-      this.onUnavailableCallbacks.forEach((callback) => {
-        try {
-          callback();
-        } catch (error) {
-          this.logger.error("Error in unavailable callback:", error);
-        }
-      });
-    }
-  }
-  /**
-   * Register callback for when resolver becomes unavailable
-   */
-  onUnavailable(callback) {
-    this.onUnavailableCallbacks.push(callback);
-  }
-  /**
-   * Remove unavailable callback
-   */
-  offUnavailable(callback) {
-    const index = this.onUnavailableCallbacks.indexOf(callback);
-    if (index !== -1) {
-      this.onUnavailableCallbacks.splice(index, 1);
-    }
-  }
-  /**
-   * Execute operation with resolver or fallback
-   */
-  async withResolver(operation, fallback) {
-    if (this.resolver) {
-      try {
-        return await operation(this.resolver);
-      } catch (error) {
-        this.logger.warn("Resolver operation failed, using fallback:", error);
-        return await fallback();
-      }
-    } else {
-      this.logger.warn("No resolver available, using fallback");
-      return await fallback();
-    }
-  }
-}
-const ContentResolverRegistry = ContentResolverRegistryImpl.getInstance();
+var CustomFeeType = /* @__PURE__ */ ((CustomFeeType2) => {
+  CustomFeeType2["FIXED_FEE"] = "FIXED_FEE";
+  CustomFeeType2["FRACTIONAL_FEE"] = "FRACTIONAL_FEE";
+  CustomFeeType2["ROYALTY_FEE"] = "ROYALTY_FEE";
+  return CustomFeeType2;
+})(CustomFeeType || {});
 export {
-  ContentResolverRegistry,
-  ContentResolverRegistryImpl
+  CustomFeeType
 };
 //# sourceMappingURL=standards-sdk.es132.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es132.js","sources":["../../src/content-store/ContentResolverRegistry.ts"],"sourcesContent":["/**\n * Content Resolver Registry\n *\n * Dependency injection registry for content resolvers.\n * Allows tools to access content resolution without circular dependencies.\n */\n\nimport type { ContentResolverInterface } from './types';\nimport { Logger } from '../utils/logger';\n\nexport class ContentResolverRegistryImpl {\n  private static _instance: ContentResolverRegistryImpl;\n  private resolver: ContentResolverInterface | null = null;\n  private onUnavailableCallbacks: (() => void)[] = [];\n  private logger = Logger.getInstance({ module: 'ContentResolverRegistry' });\n\n  static getInstance(): ContentResolverRegistryImpl {\n    if (!ContentResolverRegistryImpl._instance) {\n      ContentResolverRegistryImpl._instance = new ContentResolverRegistryImpl();\n    }\n    return ContentResolverRegistryImpl._instance;\n  }\n\n  /**\n   * Register a content resolver (typically called by ContentStoreManager)\n   */\n  register(resolver: ContentResolverInterface): void {\n    if (this.resolver) {\n      this.logger.warn('Resolver already registered, replacing existing');\n    }\n    this.resolver = resolver;\n    this.logger.info('Content resolver registered');\n  }\n\n  /**\n   * Get the registered content resolver\n   */\n  getResolver(): ContentResolverInterface | null {\n    return this.resolver;\n  }\n\n  /**\n   * Check if a resolver is available\n   */\n  isAvailable(): boolean {\n    return this.resolver !== null;\n  }\n\n  /**\n   * Unregister the current resolver\n   */\n  unregister(): void {\n    if (this.resolver) {\n      this.resolver = null;\n      this.logger.info('Content resolver unregistered');\n      this.onUnavailableCallbacks.forEach(callback => {\n        try {\n          callback();\n        } catch (error) {\n          this.logger.error('Error in unavailable callback:', error);\n        }\n      });\n    }\n  }\n\n  /**\n   * Register callback for when resolver becomes unavailable\n   */\n  onUnavailable(callback: () => void): void {\n    this.onUnavailableCallbacks.push(callback);\n  }\n\n  /**\n   * Remove unavailable callback\n   */\n  offUnavailable(callback: () => void): void {\n    const index = this.onUnavailableCallbacks.indexOf(callback);\n    if (index !== -1) {\n      this.onUnavailableCallbacks.splice(index, 1);\n    }\n  }\n\n  /**\n   * Execute operation with resolver or fallback\n   */\n  async withResolver<T>(\n    operation: (resolver: ContentResolverInterface) => Promise<T>,\n    fallback: () => Promise<T>,\n  ): Promise<T> {\n    if (this.resolver) {\n      try {\n        return await operation(this.resolver);\n      } catch (error) {\n        this.logger.warn('Resolver operation failed, using fallback:', error);\n        return await fallback();\n      }\n    } else {\n      this.logger.warn('No resolver available, using fallback');\n      return await fallback();\n    }\n  }\n}\n\nexport const ContentResolverRegistry =\n  ContentResolverRegistryImpl.getInstance();\n"],"names":[],"mappings":";AAUO,MAAM,4BAA4B;AAAA,EAAlC,cAAA;AAEL,SAAQ,WAA4C;AACpD,SAAQ,yBAAyC,CAAA;AACjD,SAAQ,SAAS,OAAO,YAAY,EAAE,QAAQ,2BAA2B;AAAA,EAAA;AAAA,EAEzE,OAAO,cAA2C;AAChD,QAAI,CAAC,4BAA4B,WAAW;AAC1C,kCAA4B,YAAY,IAAI,4BAAA;AAAA,IAC9C;AACA,WAAO,4BAA4B;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,UAA0C;AACjD,QAAI,KAAK,UAAU;AACjB,WAAK,OAAO,KAAK,iDAAiD;AAAA,IACpE;AACA,SAAK,WAAW;AAChB,SAAK,OAAO,KAAK,6BAA6B;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,cAA+C;AAC7C,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,cAAuB;AACrB,WAAO,KAAK,aAAa;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKA,aAAmB;AACjB,QAAI,KAAK,UAAU;AACjB,WAAK,WAAW;AAChB,WAAK,OAAO,KAAK,+BAA+B;AAChD,WAAK,uBAAuB,QAAQ,CAAA,aAAY;AAC9C,YAAI;AACF,mBAAA;AAAA,QACF,SAAS,OAAO;AACd,eAAK,OAAO,MAAM,kCAAkC,KAAK;AAAA,QAC3D;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,UAA4B;AACxC,SAAK,uBAAuB,KAAK,QAAQ;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,UAA4B;AACzC,UAAM,QAAQ,KAAK,uBAAuB,QAAQ,QAAQ;AAC1D,QAAI,UAAU,IAAI;AAChB,WAAK,uBAAuB,OAAO,OAAO,CAAC;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,aACJ,WACA,UACY;AACZ,QAAI,KAAK,UAAU;AACjB,UAAI;AACF,eAAO,MAAM,UAAU,KAAK,QAAQ;AAAA,MACtC,SAAS,OAAO;AACd,aAAK,OAAO,KAAK,8CAA8C,KAAK;AACpE,eAAO,MAAM,SAAA;AAAA,MACf;AAAA,IACF,OAAO;AACL,WAAK,OAAO,KAAK,uCAAuC;AACxD,aAAO,MAAM,SAAA;AAAA,IACf;AAAA,EACF;AACF;AAEO,MAAM,0BACX,4BAA4B,YAAA;"}
+{"version":3,"file":"standards-sdk.es132.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;"}