@hashgraphonline/standards-sdk 0.0.95 → 0.0.96

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es21.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: collectorAccountId || '',\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: collectorAccountId || '',\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    return {\n      customFees: this.customFees,\n      exemptAccounts: Array.from(allExemptAccounts),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es21.js","sources":["../../src/services/mirror-node.ts"],"sourcesContent":["import { PublicKey, Timestamp } from '@hashgraph/sdk';\nimport axios from 'axios';\nimport { Logger } from '../utils/logger';\nimport { HCSMessage } from '../hcs-10/base-client';\nimport { proto } from '@hashgraph/proto';\nimport {\n  AccountResponse,\n  CustomFees,\n  HBARPrice,\n  ScheduleInfo,\n  TokenInfoResponse,\n  TopicMessagesResponse,\n  TopicResponse,\n} from './types';\nimport { NetworkType } from '../utils/types';\nexport class HederaMirrorNode {\n  private network: NetworkType;\n  private baseUrl: string;\n  private logger: Logger;\n  private isServerEnvironment: boolean;\n\n  constructor(network: NetworkType, logger: Logger) {\n    this.network = network;\n    this.baseUrl = this.getMirrorNodeUrl();\n    this.logger = logger;\n    this.isServerEnvironment = typeof window === 'undefined';\n  }\n\n  private getMirrorNodeUrl(): string {\n    return this.network === 'mainnet'\n      ? 'https://mainnet-public.mirrornode.hedera.com'\n      : 'https://testnet.mirrornode.hedera.com';\n  }\n\n  getBaseUrl(): string {\n    return this.baseUrl;\n  }\n\n  /**\n   * Retrieves the public key for a given account ID from the mirror node.\n   * @param accountId The ID of the account to retrieve the public key for.\n   * @returns A promise that resolves to the public key for the given account.\n   * @throws An error if the account ID is invalid or the public key cannot be retrieved.\n   */\n  async getPublicKey(accountId: string): Promise<PublicKey> {\n    this.logger.info(`Getting public key for account ${accountId}`);\n\n    const accountInfo = await this.requestAccount(accountId);\n\n    try {\n      if (!accountInfo || !accountInfo.key) {\n        throw new Error(\n          `Failed to retrieve public key for account ID: ${accountId}`\n        );\n      }\n\n      return PublicKey.fromString(accountInfo.key.key);\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error fetching public key from Mirror Node: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n\n  /**\n   * Retrieves the memo for a given account ID from the mirror node.\n   * @param accountId The ID of the account to retrieve the memo for.\n   * @returns A promise that resolves to the memo for the given account.\n   * @throws An error if the account ID is invalid or the memo cannot be retrieved.\n   */\n  async getAccountMemo(accountId: string): Promise<string | null> {\n    const maxRetries = 3;\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        const accountInfoUrl = `${this.baseUrl}/api/v1/accounts/${accountId}`;\n\n        const response = await axios.get(accountInfoUrl);\n        const accountInfo = response.data;\n\n        if (accountInfo && accountInfo.memo) {\n          return accountInfo.memo;\n        }\n\n        this.logger.error(`No memo found for account ${accountId}`);\n\n        if (attempt < maxRetries - 1) {\n          await new Promise((resolve) => setTimeout(resolve, 2000));\n        }\n      } catch (e: any) {\n        const error = e as Error;\n        const logMessage = `Error getting account memo (attempt ${\n          attempt + 1\n        }): ${error.message}`;\n        this.logger.error(logMessage);\n\n        if (attempt < maxRetries - 1) {\n          await new Promise((resolve) => setTimeout(resolve, 2000));\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Retrieves topic information for a given topic ID from the mirror node.\n   * @param topicId The ID of the topic to retrieve information for.\n   * @returns A promise that resolves to the topic information.\n   * @throws An error if the topic ID is invalid or the information cannot be retrieved.\n   */\n  async getTopicInfo(topicId: string): Promise<TopicResponse> {\n    try {\n      const topicInfoUrl = `${this.baseUrl}/api/v1/topics/${topicId}`;\n      const response = await axios.get(topicInfoUrl);\n      return response.data;\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error retrieving topic information: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n\n  /**\n   * Retrieves custom fees for a given topic ID from the mirror node.\n   * @param topicId The ID of the topic to retrieve custom fees for.\n   * @returns A promise that resolves to the custom fees for the given topic.\n   * @throws An error if the topic ID is invalid or the custom fees cannot be retrieved.\n   */\n  async getTopicFees(topicId: string): Promise<CustomFees | null> {\n    try {\n      const topicInfo = await this.getTopicInfo(topicId);\n      return topicInfo.custom_fees;\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error retrieving topic fees: ${error.message}`;\n      this.logger.error(logMessage);\n      return null;\n    }\n  }\n\n  /**\n   * Retrieves the current HBAR price from the mirror node.\n   * @param date The date to retrieve the HBAR price for.\n   * @returns A promise that resolves to the HBAR price for the given date.\n   * @throws An error if the date is invalid or the price cannot be retrieved.\n   */\n  async getHBARPrice(date: Date): Promise<number | null> {\n    try {\n      const timestamp = Timestamp.fromDate(date).toString();\n\n      const request = await fetch(\n        `https://mainnet-public.mirrornode.hedera.com/api/v1/network/exchangerate?timestamp=${timestamp}`\n      );\n      const response = (await request.json()) as HBARPrice;\n\n      const usdPrice =\n        Number(response?.current_rate?.cent_equivalent) /\n        Number(response?.current_rate?.hbar_equivalent) /\n        100;\n\n      return usdPrice;\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error retrieving HBAR price: ${error.message}`;\n      this.logger.error(logMessage);\n      return null;\n    }\n  }\n\n  /**\n   * Retrieves token information for a given token ID from the mirror node.\n   * @param tokenId The ID of the token to retrieve information for.\n   * @returns A promise that resolves to the token information.\n   * @throws An error if the token ID is invalid or the information cannot be retrieved.\n   */\n  async getTokenInfo(tokenId: string): Promise<TokenInfoResponse | null> {\n    this.logger.debug(`Fetching token info for ${tokenId}`);\n    try {\n      const tokenInfoUrl = `${this.baseUrl}/api/v1/tokens/${tokenId}`;\n      const response = await axios.get<TokenInfoResponse>(tokenInfoUrl);\n      if (response.data) {\n        this.logger.trace(`Token info found for ${tokenId}:`, response.data);\n        return response.data;\n      }\n      this.logger.warn(`No token info found for ${tokenId}`);\n      return null;\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error fetching token info for ${tokenId}: ${error.message}`;\n      this.logger.error(logMessage);\n\n      return null;\n    }\n  }\n\n  /**\n   * Retrieves messages for a given topic ID from the mirror node.\n   * @param topicId The ID of the topic to retrieve messages for.\n   * @returns A promise that resolves to the messages for the given topic.\n   * @throws An error if the topic ID is invalid or the messages cannot be retrieved.\n   */\n  async getTopicMessages(topicId: string): Promise<HCSMessage[]> {\n    this.logger.trace(`Querying messages for topic ${topicId}`);\n\n    let nextUrl = `${this.baseUrl}/api/v1/topics/${topicId}/messages`;\n    const messages: HCSMessage[] = [];\n\n    while (nextUrl) {\n      try {\n        const response = await axios.get<TopicMessagesResponse>(nextUrl);\n        const data = response.data;\n\n        if (data.messages && data.messages.length > 0) {\n          for (const message of data.messages) {\n            try {\n              if (!message.message) {\n                continue;\n              }\n\n              let messageContent: string;\n              try {\n                if (this.isServerEnvironment) {\n                  messageContent = Buffer.from(\n                    message.message,\n                    'base64'\n                  ).toString('utf-8');\n                } else {\n                  messageContent = new TextDecoder().decode(\n                    Uint8Array.from(atob(message.message), (c) =>\n                      c.charCodeAt(0)\n                    )\n                  );\n                }\n              } catch (error) {\n                const logMessage = `Error decoding message: ${error}`;\n                this.logger.error(logMessage);\n                continue;\n              }\n\n              let messageJson;\n              try {\n                messageJson = JSON.parse(messageContent);\n              } catch (error) {\n                const logMessage = `Invalid JSON message content: ${messageContent}`;\n                this.logger.error(logMessage);\n                return;\n              }\n\n              messageJson.sequence_number = message.sequence_number;\n              messages.push({\n                ...messageJson,\n                consensus_timestamp: message.consensus_timestamp,\n                sequence_number: message.sequence_number,\n                created: new Date(Number(message.consensus_timestamp) * 1000),\n              });\n            } catch (error: any) {\n              const logMessage = `Error processing message: ${error.message}`;\n              this.logger.error(logMessage);\n            }\n          }\n        }\n\n        nextUrl = data.links?.next ? `${this.baseUrl}${data.links.next}` : '';\n      } catch (e: any) {\n        const error = e as Error;\n        const logMessage = `Error querying topic messages: ${error.message} on ${topicId}`;\n        this.logger.error(logMessage);\n        throw new Error(logMessage);\n      }\n    }\n\n    return messages;\n  }\n\n  /**\n   * Requests account information for a given account ID from the mirror node.\n   * @param accountId The ID of the account to retrieve information for.\n   * @returns A promise that resolves to the account information.\n   * @throws An error if the account ID is invalid or the information cannot be retrieved.\n   */\n  async requestAccount(accountId: string): Promise<AccountResponse> {\n    try {\n      const accountInfoUrl = `${this.baseUrl}/api/v1/accounts/${accountId}`;\n      const response = await axios.get(accountInfoUrl);\n      if (!response.data) {\n        throw new Error(\n          `Failed to make request to mirror node for account: ${accountId}`\n        );\n      }\n      return response.data;\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Failed to fetch account: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n\n  /**\n   * Checks if a user has access to a given key list.\n   * @param keyBytes The key list to check access for.\n   * @param userPublicKey The public key of the user to check access for.\n   * @returns A promise that resolves to true if the user has access, false otherwise.\n   */\n  async checkKeyListAccess(\n    keyBytes: Buffer,\n    userPublicKey: PublicKey\n  ): Promise<boolean> {\n    try {\n      const key = proto.Key.decode(keyBytes);\n      return this.evaluateKeyAccess(key, userPublicKey);\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error decoding protobuf key: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n\n  /**\n   * Evaluates the access of a given key to a user's public key.\n   * @param key The key to evaluate access for.\n   * @param userPublicKey The public key of the user to evaluate access for.\n   * @returns A promise that resolves to true if the key has access, false otherwise.\n   */\n  private async evaluateKeyAccess(\n    key: proto.IKey,\n    userPublicKey: PublicKey\n  ): Promise<boolean> {\n    if (key.ed25519) {\n      return this.compareEd25519Key(key.ed25519, userPublicKey);\n    }\n\n    if (key.keyList) {\n      return this.evaluateKeyList(key.keyList, userPublicKey);\n    }\n\n    if (key.thresholdKey && key.thresholdKey.keys) {\n      return this.evaluateKeyList(key.thresholdKey.keys, userPublicKey);\n    }\n\n    return false;\n  }\n\n  /**\n   * Evaluates the access of a given key list to a user's public key.\n   * @param keyList The key list to evaluate access for.\n   * @param userPublicKey The public key of the user to evaluate access for.\n   * @returns A promise that resolves to true if the key list has access, false otherwise.\n   */\n  private async evaluateKeyList(\n    keyList: proto.IKeyList,\n    userPublicKey: PublicKey\n  ): Promise<boolean> {\n    const keys = keyList.keys || [];\n\n    for (const listKey of keys) {\n      if (!listKey) continue;\n\n      if (listKey.ed25519) {\n        if (this.compareEd25519Key(listKey.ed25519, userPublicKey)) {\n          return true;\n        }\n      } else if (listKey.keyList || listKey.thresholdKey) {\n        try {\n          const nestedKeyBytes = proto.Key.encode({\n            ...(listKey.keyList ? { keyList: listKey.keyList } : {}),\n            ...(listKey.thresholdKey\n              ? { thresholdKey: listKey.thresholdKey }\n              : {}),\n          }).finish();\n\n          const hasNestedAccess = await this.checkKeyListAccess(\n            Buffer.from(nestedKeyBytes),\n            userPublicKey\n          );\n\n          if (hasNestedAccess) {\n            return true;\n          }\n        } catch (e: any) {\n          const error = e as Error;\n          const logMessage = `Error in nested key: ${error.message}`;\n          this.logger.debug(logMessage);\n        }\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * Compares an Ed25519 key with a user's public key.\n   * @param keyData The Ed25519 key data to compare.\n   * @param userPublicKey The public key of the user to compare with.\n   * @returns A boolean indicating whether the key matches the user's public key.\n   */\n  private compareEd25519Key(\n    keyData: Uint8Array,\n    userPublicKey: PublicKey\n  ): boolean {\n    try {\n      const decodedKey = PublicKey.fromBytes(Buffer.from(keyData));\n      return decodedKey.toString() === userPublicKey.toString();\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error comparing Ed25519 key: ${error.message}`;\n      this.logger.debug(logMessage);\n      return false;\n    }\n  }\n\n  /**\n   * Retrieves information about a scheduled transaction\n   * @param scheduleId The ID of the scheduled transaction\n   * @returns A promise that resolves to the scheduled transaction information\n   */\n  async getScheduleInfo(scheduleId: string): Promise<ScheduleInfo | null> {\n    try {\n      this.logger.info(\n        `Getting information for scheduled transaction ${scheduleId}`\n      );\n\n      const url = `${this.baseUrl}/api/v1/schedules/${scheduleId}`;\n      const response = await axios.get(url);\n\n      if (response.data) {\n        return response.data as ScheduleInfo;\n      }\n\n      return null;\n    } catch (error: any) {\n      this.logger.error(`Error fetching schedule info: ${error.message}`);\n      return null;\n    }\n  }\n\n  /**\n   * Checks the status of a scheduled transaction\n   * @param scheduleId The schedule ID to check\n   * @returns Status of the scheduled transaction\n   */\n  public async getScheduledTransactionStatus(scheduleId: string): Promise<{\n    executed: boolean;\n    executedDate?: Date;\n    deleted: boolean;\n  }> {\n    try {\n      this.logger.info(\n        `Checking status of scheduled transaction ${scheduleId}`\n      );\n\n      const scheduleInfo = await this.getScheduleInfo(scheduleId);\n\n      if (!scheduleInfo) {\n        throw new Error(`Schedule ${scheduleId} not found`);\n      }\n\n      return {\n        executed: Boolean(scheduleInfo.executed_timestamp),\n        executedDate: scheduleInfo.executed_timestamp\n          ? new Date(Number(scheduleInfo.executed_timestamp) * 1000)\n          : undefined,\n        deleted: scheduleInfo.deleted || false,\n      };\n    } catch (error) {\n      this.logger.error(\n        `Error checking scheduled transaction status: ${error}`\n      );\n      throw error;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,158 @@
-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.es23.js";
+import { HederaMirrorNode } from "./standards-sdk.es21.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 || "",
+      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 || "",
+      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));
+    });
+    return {
+      customFees: this.customFees,
+      exemptAccounts: Array.from(allExemptAccounts)
+    };
+  }
+}
 export {
-  CustomFeeType
+  FeeConfigBuilder
 };
 //# sourceMappingURL=standards-sdk.es22.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es22.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":"AAgBY,IAAA,kCAAAA,mBAAL;AACLA,iBAAA,WAAY,IAAA;AACZA,iBAAA,gBAAiB,IAAA;AACjBA,iBAAA,aAAc,IAAA;AAHJA,SAAAA;AAAA,GAAA,iBAAA,CAAA,CAAA;"}
+{"version":3,"file":"standards-sdk.es22.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: collectorAccountId || '',\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: collectorAccountId || '',\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    return {\n      customFees: this.customFees,\n      exemptAccounts: Array.from(allExemptAccounts),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}