@hashgraphonline/standards-sdk 0.1.137 → 0.1.138-feat-hcs-21-package-std.canary.9db1bab.34

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

@@ -1,1570 +1,1143 @@
-import { PublicKey, Timestamp, AccountId } from "@hashgraph/sdk";
-import axios from "axios";
-import { Logger } from "./standards-sdk.es99.js";
 import { proto } from "@hashgraph/proto";
-class HederaMirrorNode {
-  constructor(network, logger, config) {
-    this.maxRetries = 5;
-    this.initialDelayMs = 2e3;
-    this.maxDelayMs = 3e4;
-    this.backoffFactor = 2;
-    this.network = network;
-    this.apiKey = config?.apiKey;
-    this.customHeaders = config?.headers || {};
-    this.baseUrl = config?.customUrl || this.getMirrorNodeUrl();
-    this.logger = logger || new Logger({
-      level: "debug",
-      module: "MirrorNode"
-    });
-    this.isServerEnvironment = typeof window === "undefined";
-    if (config?.customUrl) {
-      this.logger.info(`Using custom mirror node URL: ${config.customUrl}`);
-    }
-    if (config?.apiKey) {
-      this.logger.info("Using API key for mirror node requests");
-    }
-  }
-  /**
-   * Configures the retry mechanism for API requests.
-   * @param config The retry configuration.
-   */
-  configureRetry(config) {
-    this.maxRetries = config.maxRetries ?? this.maxRetries;
-    this.initialDelayMs = config.initialDelayMs ?? this.initialDelayMs;
-    this.maxDelayMs = config.maxDelayMs ?? this.maxDelayMs;
-    this.backoffFactor = config.backoffFactor ?? this.backoffFactor;
-    this.logger.info(
-      `Retry configuration updated: maxRetries=${this.maxRetries}, initialDelayMs=${this.initialDelayMs}, maxDelayMs=${this.maxDelayMs}, backoffFactor=${this.backoffFactor}`
-    );
-  }
-  /**
-   * Updates the mirror node configuration.
-   * @param config The new mirror node configuration.
-   */
-  configureMirrorNode(config) {
-    if (config.customUrl) {
-      this.baseUrl = config.customUrl;
-      this.logger.info(`Updated mirror node URL: ${config.customUrl}`);
-    }
-    if (config.apiKey) {
-      this.apiKey = config.apiKey;
-      this.logger.info("Updated API key for mirror node requests");
-    }
-    if (config.headers) {
-      this.customHeaders = { ...this.customHeaders, ...config.headers };
-      this.logger.info("Updated custom headers for mirror node requests");
-    }
-  }
-  /**
-   * Constructs a full URL for API requests, handling custom providers with API keys in the path.
-   * @param endpoint The API endpoint (e.g., '/api/v1/accounts/0.0.123')
-   * @returns The full URL for the request
-   */
-  constructUrl(endpoint) {
-    if (this.baseUrl.includes("<API-KEY>") && this.apiKey) {
-      const baseUrlWithKey = this.baseUrl.replace("<API-KEY>", this.apiKey);
-      return endpoint.startsWith("/") ? `${baseUrlWithKey}${endpoint}` : `${baseUrlWithKey}/${endpoint}`;
-    }
-    return endpoint.startsWith("/") ? `${this.baseUrl}${endpoint}` : `${this.baseUrl}/${endpoint}`;
-  }
+import { AccountId, Long, TokenId } from "@hashgraph/sdk";
+import { parseKey, hasTransactionType, extractTransactionBody } from "./standards-sdk.es147.js";
+import { Buffer } from "buffer";
+class HTSParser {
   /**
-   * Returns the base URL for the Hedera mirror node based on the network type
-   * @returns The mirror node base URL
-   * @private
+   * Main entry point for parsing HTS transactions from a Transaction object
+   * This method bridges between the Transaction object and the protobuf parsers
    */
-  getMirrorNodeUrl() {
-    return this.network === "mainnet" ? "https://mainnet-public.mirrornode.hedera.com" : "https://testnet.mirrornode.hedera.com";
-  }
-  getBaseUrl() {
-    return this.baseUrl;
-  }
-  /**
-   * Retrieves the public key for a given account ID from the mirror node.
-   * @param accountId The ID of the account to retrieve the public key for.
-   * @returns A promise that resolves to the public key for the given account.
-   * @throws An error if the account ID is invalid or the public key cannot be retrieved.
-   */
-  async getPublicKey(accountId) {
-    this.logger.debug(`Getting public key for account ${accountId}`);
-    const accountInfo = await this.requestAccount(accountId);
+  static parseHTSTransaction(transaction) {
     try {
-      if (!accountInfo || !accountInfo.key) {
-        throw new Error(
-          `Failed to retrieve public key for account ID: ${accountId}`
+      const transactionBody = transaction._transactionBody;
+      if (!transactionBody) {
+        return {};
+      }
+      if (transactionBody.tokenCreation) {
+        const tokenCreation = this.parseTokenCreate(
+          transactionBody.tokenCreation
         );
+        if (tokenCreation) {
+          return {
+            type: "TOKENCREATE",
+            humanReadableType: "Token Creation",
+            tokenCreation
+          };
+        }
       }
-      return PublicKey.fromString(accountInfo.key.key);
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error fetching public key from Mirror Node: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
-    }
-  }
-  /**
-   * Retrieves the memo for a given account ID from the mirror node.
-   * @param accountId The ID of the account to retrieve the memo for.
-   * @returns A promise that resolves to the memo for the given account.
-   * @throws An error if the account ID is invalid or the memo cannot be retrieved.
-   */
-  async getAccountMemo(accountId) {
-    this.logger.debug(`Getting account memo for account ID: ${accountId}`);
-    try {
-      const accountInfo = await this._requestWithRetry(
-        `/api/v1/accounts/${accountId}`
-      );
-      if (accountInfo?.memo) {
-        return accountInfo.memo;
+      if (transactionBody.tokenMint) {
+        const tokenMint = this.parseTokenMint(transactionBody.tokenMint);
+        if (tokenMint) {
+          return {
+            type: "TOKENMINT",
+            humanReadableType: "Token Mint",
+            tokenMint
+          };
+        }
       }
-      this.logger.warn(`No memo found for account ${accountId}`);
-      return null;
-    } catch (e) {
-      const error = e;
-      this.logger.error(
-        `Failed to get account memo for ${accountId} after retries: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves topic information for a given topic ID from the mirror node.
-   * @param topicId The ID of the topic to retrieve information for.
-   * @returns A promise that resolves to the topic information.
-   * @throws An error if the topic ID is invalid or the information cannot be retrieved.
-   */
-  async getTopicInfo(topicId) {
-    try {
-      this.logger.debug(`Fetching topic info for ${topicId}`);
-      const data = await this._requestWithRetry(
-        `/api/v1/topics/${topicId}`
-      );
-      return data;
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error retrieving topic information for ${topicId} after retries: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
-    }
-  }
-  /**
-   * Retrieves custom fees for a given topic ID from the mirror node.
-   * @param topicId The ID of the topic to retrieve custom fees for.
-   * @returns A promise that resolves to the custom fees for the given topic.
-   * @throws An error if the topic ID is invalid or the custom fees cannot be retrieved.
-   */
-  async getTopicFees(topicId) {
-    try {
-      const topicInfo = await this.getTopicInfo(topicId);
-      return topicInfo.custom_fees;
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error retrieving topic fees: ${error.message}`;
-      this.logger.error(logMessage);
-      return null;
-    }
-  }
-  /**
-   * Retrieves the current HBAR price from the mirror node.
-   * @param date The date to retrieve the HBAR price for.
-   * @returns A promise that resolves to the HBAR price for the given date.
-   * @throws An error if the date is invalid or the price cannot be retrieved.
-   */
-  async getHBARPrice(date) {
-    try {
-      const timestamp = Timestamp.fromDate(date).toString();
-      this.logger.debug(`Fetching HBAR price for timestamp ${timestamp}`);
-      const response = await this._requestWithRetry(
-        `/api/v1/network/exchangerate?timestamp=${timestamp}`
-      );
-      const usdPrice = Number(response?.current_rate?.cent_equivalent) / Number(response?.current_rate?.hbar_equivalent) / 100;
-      return usdPrice;
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error retrieving HBAR price: ${error.message}`;
-      this.logger.error(logMessage);
-      return null;
-    }
-  }
-  /**
-   * Retrieves token information for a given token ID from the mirror node.
-   * @param tokenId The ID of the token to retrieve information for.
-   * @returns A promise that resolves to the token information.
-   * @throws An error if the token ID is invalid or the information cannot be retrieved.
-   */
-  async getTokenInfo(tokenId) {
-    this.logger.debug(`Fetching token info for ${tokenId}`);
-    try {
-      const data = await this._requestWithRetry(
-        `/api/v1/tokens/${tokenId}`
-      );
-      if (data) {
-        this.logger.trace(`Token info found for ${tokenId}:`, data);
-        return data;
+      if (transactionBody.tokenBurn) {
+        const tokenBurn = this.parseTokenBurn(transactionBody.tokenBurn);
+        if (tokenBurn) {
+          return {
+            type: "TOKENBURN",
+            humanReadableType: "Token Burn",
+            tokenBurn
+          };
+        }
       }
-      this.logger.warn(`No token info found for ${tokenId}`);
-      return null;
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error fetching token info for ${tokenId}: ${error.message}`;
-      this.logger.error(logMessage);
-      return null;
-    }
-  }
-  /**
-   * Retrieves messages for a given topic ID from the mirror node. Supports filtering by sequence number
-   * based on the OpenAPI specification.
-   * @param topicId The ID of the topic to retrieve messages for.
-   * @param options Optional filtering parameters.
-   * @returns A promise that resolves to the messages for the given topic.
-   */
-  async getTopicMessages(topicId, options) {
-    this.logger.trace(
-      `Querying messages for topic ${topicId}${options ? " with filters" : ""}`
-    );
-    let endpoint = `/api/v1/topics/${topicId}/messages`;
-    const params = new URLSearchParams();
-    if (options) {
-      if (options.sequenceNumber !== void 0) {
-        const seqNum = typeof options.sequenceNumber === "number" ? options.sequenceNumber.toString() : options.sequenceNumber;
-        if (!seqNum.match(/^(gt|gte|lt|lte|eq|ne):/)) {
-          params.append("sequencenumber", `gt:${seqNum}`);
-        } else {
-          params.append("sequencenumber", seqNum);
+      if (transactionBody.tokenUpdate) {
+        const tokenUpdate = this.parseTokenUpdate(transactionBody.tokenUpdate);
+        if (tokenUpdate) {
+          return {
+            type: "TOKENUPDATE",
+            humanReadableType: "Token Update",
+            tokenUpdate
+          };
         }
       }
-      if (options.limit) {
-        params.append("limit", options.limit.toString());
+      if (transactionBody.tokenFreeze) {
+        const tokenFreeze = this.parseTokenFreeze(transactionBody.tokenFreeze);
+        if (tokenFreeze) {
+          return {
+            type: "TOKENFREEZE",
+            humanReadableType: "Token Freeze",
+            tokenFreeze
+          };
+        }
       }
-      if (options.order) {
-        params.append("order", options.order);
+      if (transactionBody.tokenUnfreeze) {
+        const tokenUnfreeze = this.parseTokenUnfreeze(
+          transactionBody.tokenUnfreeze
+        );
+        if (tokenUnfreeze) {
+          return {
+            type: "TOKENUNFREEZE",
+            humanReadableType: "Token Unfreeze",
+            tokenUnfreeze
+          };
+        }
       }
+      if (transactionBody.tokenGrantKyc) {
+        const tokenGrantKyc = this.parseTokenGrantKyc(
+          transactionBody.tokenGrantKyc
+        );
+        if (tokenGrantKyc) {
+          return {
+            type: "TOKENGRANTKYC",
+            humanReadableType: "Token Grant KYC",
+            tokenGrantKyc
+          };
+        }
+      }
+      if (transactionBody.tokenRevokeKyc) {
+        const tokenRevokeKyc = this.parseTokenRevokeKyc(
+          transactionBody.tokenRevokeKyc
+        );
+        if (tokenRevokeKyc) {
+          return {
+            type: "TOKENREVOKEKYC",
+            humanReadableType: "Token Revoke KYC",
+            tokenRevokeKyc
+          };
+        }
+      }
+      if (transactionBody.tokenPause) {
+        const tokenPause = this.parseTokenPause(transactionBody.tokenPause);
+        if (tokenPause) {
+          return {
+            type: "TOKENPAUSE",
+            humanReadableType: "Token Pause",
+            tokenPause
+          };
+        }
+      }
+      if (transactionBody.tokenUnpause) {
+        const tokenUnpause = this.parseTokenUnpause(
+          transactionBody.tokenUnpause
+        );
+        if (tokenUnpause) {
+          return {
+            type: "TOKENUNPAUSE",
+            humanReadableType: "Token Unpause",
+            tokenUnpause
+          };
+        }
+      }
+      if (transactionBody.tokenWipe) {
+        const tokenWipeAccount = this.parseTokenWipeAccount(
+          transactionBody.tokenWipe
+        );
+        if (tokenWipeAccount) {
+          return {
+            type: "TOKENWIPEACCOUNT",
+            humanReadableType: "Token Wipe Account",
+            tokenWipeAccount
+          };
+        }
+      }
+      if (transactionBody.tokenDeletion) {
+        const tokenDelete = this.parseTokenDelete(
+          transactionBody.tokenDeletion
+        );
+        if (tokenDelete) {
+          return {
+            type: "TOKENDELETE",
+            humanReadableType: "Token Delete",
+            tokenDelete
+          };
+        }
+      }
+      if (transactionBody.tokenAssociate) {
+        const tokenAssociate = this.parseTokenAssociate(
+          transactionBody.tokenAssociate
+        );
+        if (tokenAssociate) {
+          return {
+            type: "TOKENASSOCIATE",
+            humanReadableType: "Token Associate",
+            tokenAssociate
+          };
+        }
+      }
+      if (transactionBody.tokenDissociate) {
+        const tokenDissociate = this.parseTokenDissociate(
+          transactionBody.tokenDissociate
+        );
+        if (tokenDissociate) {
+          return {
+            type: "TOKENDISSOCIATE",
+            humanReadableType: "Token Dissociate",
+            tokenDissociate
+          };
+        }
+      }
+      if (transactionBody.tokenFeeScheduleUpdate) {
+        const tokenFeeScheduleUpdate = this.parseTokenFeeScheduleUpdate(
+          transactionBody.tokenFeeScheduleUpdate
+        );
+        if (tokenFeeScheduleUpdate) {
+          return {
+            type: "TOKENFEESCHEDULEUPDATE",
+            humanReadableType: "Token Fee Schedule Update",
+            tokenFeeScheduleUpdate
+          };
+        }
+      }
+      const airdrop = this.parseTokenAirdrop(transaction);
+      if (airdrop) {
+        return {
+          type: "TOKENAIRDROP",
+          humanReadableType: "Token Airdrop",
+          tokenAirdrop: airdrop
+        };
+      }
+      return {};
+    } catch (error) {
+      console.warn("[HTSParser] Failed to parse HTS transaction:", error);
+      return {};
     }
-    const queryString = params.toString();
-    if (queryString) {
-      endpoint += `?${queryString}`;
-    }
-    const messages = [];
-    let nextEndpoint = endpoint;
-    while (nextEndpoint) {
-      try {
-        const data = await this._requestWithRetry(nextEndpoint);
-        if (data.messages && data.messages.length > 0) {
-          for (const message of data.messages) {
-            try {
-              if (!message.message) {
-                continue;
-              }
-              let messageContent;
-              try {
-                if (this.isServerEnvironment) {
-                  messageContent = Buffer.from(
-                    message.message,
-                    "base64"
-                  ).toString("utf-8");
-                } else {
-                  messageContent = new TextDecoder().decode(
-                    Uint8Array.from(
-                      atob(message.message),
-                      (c) => c.charCodeAt(0)
-                    )
-                  );
-                }
-              } catch (error) {
-                const logMessage = `Error decoding message: ${error}`;
-                this.logger.error(logMessage);
-                continue;
-              }
-              let messageJson;
-              try {
-                messageJson = JSON.parse(messageContent);
-              } catch (error) {
-                const logMessage = `Invalid JSON message content: ${messageContent}`;
-                this.logger.error(logMessage);
-                continue;
-              }
-              messageJson.sequence_number = message.sequence_number;
-              messages.push({
-                ...messageJson,
-                consensus_timestamp: message.consensus_timestamp,
-                sequence_number: message.sequence_number,
-                running_hash: message.running_hash,
-                running_hash_version: message.running_hash_version,
-                topic_id: message.topic_id,
-                payer: message.payer_account_id,
-                created: new Date(Number(message.consensus_timestamp) * 1e3)
-              });
-            } catch (error) {
-              const logMessage = `Error processing message: ${error.message}`;
-              this.logger.error(logMessage);
+  }
+  static parseTokenCreate(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.name) {
+      data.tokenName = body.name;
+    }
+    if (body.symbol) {
+      data.tokenSymbol = body.symbol;
+    }
+    if (body.treasury) {
+      data.treasuryAccountId = new AccountId(
+        body.treasury.shardNum ?? 0,
+        body.treasury.realmNum ?? 0,
+        body.treasury.accountNum ?? 0
+      ).toString();
+    }
+    if (body.initialSupply) {
+      data.initialSupply = Long.fromValue(body.initialSupply).toString();
+    }
+    if (body.decimals !== void 0 && body.decimals !== null) {
+      data.decimals = Long.fromValue(body.decimals).toNumber();
+    }
+    if (body.maxSupply) {
+      data.maxSupply = Long.fromValue(body.maxSupply).toString();
+    }
+    if (body.memo) {
+      data.memo = body.memo;
+    }
+    if (body.tokenType !== null && body.tokenType !== void 0) {
+      data.tokenType = proto.TokenType[body.tokenType];
+    }
+    if (body.supplyType !== null && body.supplyType !== void 0) {
+      data.supplyType = proto.TokenSupplyType[body.supplyType];
+    }
+    data.adminKey = parseKey(body.adminKey);
+    data.kycKey = parseKey(body.kycKey);
+    data.freezeKey = parseKey(body.freezeKey);
+    data.wipeKey = parseKey(body.wipeKey);
+    data.supplyKey = parseKey(body.supplyKey);
+    data.feeScheduleKey = parseKey(body.feeScheduleKey);
+    data.pauseKey = parseKey(body.pauseKey);
+    if (body.autoRenewAccount) {
+      data.autoRenewAccount = new AccountId(
+        body.autoRenewAccount.shardNum ?? 0,
+        body.autoRenewAccount.realmNum ?? 0,
+        body.autoRenewAccount.accountNum ?? 0
+      ).toString();
+    }
+    if (body.autoRenewPeriod?.seconds) {
+      data.autoRenewPeriod = Long.fromValue(
+        body.autoRenewPeriod.seconds
+      ).toString();
+    }
+    if (body.customFees && body.customFees.length > 0) {
+      data.customFees = body.customFees.map((fee) => {
+        const feeCollectorAccountId = fee.feeCollectorAccountId ? new AccountId(
+          fee.feeCollectorAccountId.shardNum ?? 0,
+          fee.feeCollectorAccountId.realmNum ?? 0,
+          fee.feeCollectorAccountId.accountNum ?? 0
+        ).toString() : "Not Set";
+        const commonFeeData = {
+          feeCollectorAccountId,
+          allCollectorsAreExempt: fee.allCollectorsAreExempt || false
+        };
+        if (fee.fixedFee) {
+          return {
+            ...commonFeeData,
+            feeType: "FIXED_FEE",
+            fixedFee: {
+              amount: Long.fromValue(fee.fixedFee.amount || 0).toString(),
+              denominatingTokenId: fee.fixedFee.denominatingTokenId ? new TokenId(
+                fee.fixedFee.denominatingTokenId.shardNum ?? 0,
+                fee.fixedFee.denominatingTokenId.realmNum ?? 0,
+                fee.fixedFee.denominatingTokenId.tokenNum ?? 0
+              ).toString() : void 0
             }
+          };
+        } else if (fee.fractionalFee) {
+          return {
+            ...commonFeeData,
+            feeType: "FRACTIONAL_FEE",
+            fractionalFee: {
+              numerator: Long.fromValue(
+                fee.fractionalFee.fractionalAmount?.numerator || 0
+              ).toString(),
+              denominator: Long.fromValue(
+                fee.fractionalFee.fractionalAmount?.denominator || 1
+              ).toString(),
+              minimumAmount: Long.fromValue(
+                fee.fractionalFee.minimumAmount || 0
+              ).toString(),
+              maximumAmount: Long.fromValue(
+                fee.fractionalFee.maximumAmount || 0
+              ).toString(),
+              netOfTransfers: fee.fractionalFee.netOfTransfers || false
+            }
+          };
+        } else if (fee.royaltyFee) {
+          let fallbackFeeData = void 0;
+          if (fee.royaltyFee.fallbackFee) {
+            fallbackFeeData = {
+              amount: Long.fromValue(
+                fee.royaltyFee.fallbackFee.amount || 0
+              ).toString(),
+              denominatingTokenId: fee.royaltyFee.fallbackFee.denominatingTokenId ? new TokenId(
+                fee.royaltyFee.fallbackFee.denominatingTokenId.shardNum ?? 0,
+                fee.royaltyFee.fallbackFee.denominatingTokenId.realmNum ?? 0,
+                fee.royaltyFee.fallbackFee.denominatingTokenId.tokenNum ?? 0
+              ).toString() : void 0
+            };
           }
+          return {
+            ...commonFeeData,
+            feeType: "ROYALTY_FEE",
+            royaltyFee: {
+              numerator: Long.fromValue(
+                fee.royaltyFee.exchangeValueFraction?.numerator || 0
+              ).toString(),
+              denominator: Long.fromValue(
+                fee.royaltyFee.exchangeValueFraction?.denominator || 1
+              ).toString(),
+              fallbackFee: fallbackFeeData
+            }
+          };
         }
-        nextEndpoint = data.links?.next || "";
-      } catch (e) {
-        const error = e;
-        const logMessage = `Error querying topic messages for topic ${topicId} (endpoint: ${nextEndpoint}) after retries: ${error.message}`;
-        this.logger.error(logMessage);
-        throw new Error(logMessage);
-      }
-    }
-    return messages;
+        return {
+          ...commonFeeData,
+          feeType: "FIXED_FEE",
+          fixedFee: { amount: "0" }
+        };
+      });
+    }
+    return data;
   }
-  /**
-   * Requests account information for a given account ID from the mirror node.
-   * @param accountId The ID of the account to retrieve information for.
-   * @returns A promise that resolves to the account information.
-   * @throws An error if the account ID is invalid or the information cannot be retrieved.
-   */
-  async requestAccount(accountId) {
-    try {
-      this.logger.debug(`Requesting account info for ${accountId}`);
-      const data = await this._requestWithRetry(
-        `/api/v1/accounts/${accountId}`
+  static parseTokenMint(body) {
+    if (!body || !body.token || body.amount === null || body.amount === void 0) {
+      return void 0;
+    }
+    const data = {
+      tokenId: new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString(),
+      amount: Long.fromValue(body.amount).toNumber()
+    };
+    if (body.metadata && body.metadata.length > 0) {
+      data.metadata = body.metadata.map(
+        (meta) => Buffer.from(meta).toString("base64")
       );
-      if (!data) {
-        throw new Error(
-          `No data received from mirror node for account: ${accountId}`
-        );
-      }
-      return data;
-    } catch (e) {
-      const error = e;
-      const logMessage = `Failed to fetch account ${accountId} after retries: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
     }
+    return data;
   }
-  /**
-   * Checks if a user has access to a given key list.
-   * @param keyBytes The key list to check access for.
-   * @param userPublicKey The public key of the user to check access for.
-   * @returns A promise that resolves to true if the user has access, false otherwise.
-   */
-  async checkKeyListAccess(keyBytes, userPublicKey) {
-    try {
-      const key = proto.Key.decode(keyBytes);
-      return this.evaluateKeyAccess(key, userPublicKey);
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error decoding protobuf key: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
+  static parseTokenBurn(body) {
+    if (!body || !body.token || body.amount === null || body.amount === void 0) {
+      return void 0;
+    }
+    const data = {
+      tokenId: new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString(),
+      amount: Long.fromValue(body.amount).toNumber()
+    };
+    if (body.serialNumbers && body.serialNumbers.length > 0) {
+      data.serialNumbers = body.serialNumbers.map(
+        (sn) => Long.fromValue(sn).toNumber()
+      );
     }
+    return data;
   }
-  /**
-   * Evaluates the access of a given key to a user's public key.
-   * @param key The key to evaluate access for.
-   * @param userPublicKey The public key of the user to evaluate access for.
-   * @returns A promise that resolves to true if the key has access, false otherwise.
-   */
-  async evaluateKeyAccess(key, userPublicKey) {
-    if (key.ed25519) {
-      return this.compareEd25519Key(key.ed25519, userPublicKey);
-    }
-    if (key.keyList) {
-      return this.evaluateKeyList(key.keyList, userPublicKey);
-    }
-    if (key.thresholdKey && key.thresholdKey.keys) {
-      return this.evaluateKeyList(key.thresholdKey.keys, userPublicKey);
-    }
-    return false;
+  static parseTokenUpdate(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.name) {
+      data.name = body.name;
+    }
+    if (body.symbol) {
+      data.symbol = body.symbol;
+    }
+    if (body.treasury) {
+      data.treasuryAccountId = new AccountId(
+        body.treasury.shardNum ?? 0,
+        body.treasury.realmNum ?? 0,
+        body.treasury.accountNum ?? 0
+      ).toString();
+    }
+    data.adminKey = parseKey(body.adminKey);
+    data.kycKey = parseKey(body.kycKey);
+    data.freezeKey = parseKey(body.freezeKey);
+    data.wipeKey = parseKey(body.wipeKey);
+    data.supplyKey = parseKey(body.supplyKey);
+    data.feeScheduleKey = parseKey(body.feeScheduleKey);
+    data.pauseKey = parseKey(body.pauseKey);
+    if (body.autoRenewAccount) {
+      data.autoRenewAccountId = new AccountId(
+        body.autoRenewAccount.shardNum ?? 0,
+        body.autoRenewAccount.realmNum ?? 0,
+        body.autoRenewAccount.accountNum ?? 0
+      ).toString();
+    }
+    if (body.autoRenewPeriod?.seconds) {
+      data.autoRenewPeriod = Long.fromValue(
+        body.autoRenewPeriod.seconds
+      ).toString();
+    }
+    if (body.memo?.value !== void 0) {
+      data.memo = body.memo.value;
+    }
+    if (body.expiry?.seconds) {
+      data.expiry = `${Long.fromValue(body.expiry.seconds).toString()}.${body.expiry.nanos}`;
+    }
+    return data;
   }
-  /**
-   * Evaluates the access of a given key list to a user's public key.
-   * @param keyList The key list to evaluate access for.
-   * @param userPublicKey The public key of the user to evaluate access for.
-   * @returns A promise that resolves to true if the key list has access, false otherwise.
-   */
-  async evaluateKeyList(keyList, userPublicKey) {
-    const keys = keyList.keys || [];
-    for (const listKey of keys) {
-      if (!listKey) continue;
-      if (listKey.ed25519) {
-        if (this.compareEd25519Key(listKey.ed25519, userPublicKey)) {
-          return true;
-        }
-      } else if (listKey.keyList || listKey.thresholdKey) {
-        try {
-          const nestedKeyBytes = proto.Key.encode({
-            ...listKey.keyList ? { keyList: listKey.keyList } : {},
-            ...listKey.thresholdKey ? { thresholdKey: listKey.thresholdKey } : {}
-          }).finish();
-          const hasNestedAccess = await this.checkKeyListAccess(
-            Buffer.from(nestedKeyBytes),
-            userPublicKey
-          );
-          if (hasNestedAccess) {
-            return true;
+  static parseTokenFeeScheduleUpdate(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.tokenId) {
+      data.tokenId = new TokenId(
+        body.tokenId.shardNum ?? 0,
+        body.tokenId.realmNum ?? 0,
+        body.tokenId.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.customFees && body.customFees.length > 0) {
+      data.customFees = body.customFees.map((fee) => {
+        const feeCollectorAccountId = fee.feeCollectorAccountId ? new AccountId(
+          fee.feeCollectorAccountId.shardNum ?? 0,
+          fee.feeCollectorAccountId.realmNum ?? 0,
+          fee.feeCollectorAccountId.accountNum ?? 0
+        ).toString() : "Not Set";
+        const commonFeeData = {
+          feeCollectorAccountId,
+          allCollectorsAreExempt: fee.allCollectorsAreExempt || false
+        };
+        if (fee.fixedFee) {
+          return {
+            ...commonFeeData,
+            feeType: "FIXED_FEE",
+            fixedFee: {
+              amount: Long.fromValue(fee.fixedFee.amount || 0).toString(),
+              denominatingTokenId: fee.fixedFee.denominatingTokenId ? new TokenId(
+                fee.fixedFee.denominatingTokenId.shardNum ?? 0,
+                fee.fixedFee.denominatingTokenId.realmNum ?? 0,
+                fee.fixedFee.denominatingTokenId.tokenNum ?? 0
+              ).toString() : void 0
+            }
+          };
+        } else if (fee.fractionalFee) {
+          return {
+            ...commonFeeData,
+            feeType: "FRACTIONAL_FEE",
+            fractionalFee: {
+              numerator: Long.fromValue(
+                fee.fractionalFee.fractionalAmount?.numerator || 0
+              ).toString(),
+              denominator: Long.fromValue(
+                fee.fractionalFee.fractionalAmount?.denominator || 1
+              ).toString(),
+              minimumAmount: Long.fromValue(
+                fee.fractionalFee.minimumAmount || 0
+              ).toString(),
+              maximumAmount: Long.fromValue(
+                fee.fractionalFee.maximumAmount || 0
+              ).toString(),
+              netOfTransfers: fee.fractionalFee.netOfTransfers || false
+            }
+          };
+        } else if (fee.royaltyFee) {
+          let fallbackFeeData = void 0;
+          if (fee.royaltyFee.fallbackFee) {
+            fallbackFeeData = {
+              amount: Long.fromValue(
+                fee.royaltyFee.fallbackFee.amount || 0
+              ).toString(),
+              denominatingTokenId: fee.royaltyFee.fallbackFee.denominatingTokenId ? new TokenId(
+                fee.royaltyFee.fallbackFee.denominatingTokenId.shardNum ?? 0,
+                fee.royaltyFee.fallbackFee.denominatingTokenId.realmNum ?? 0,
+                fee.royaltyFee.fallbackFee.denominatingTokenId.tokenNum ?? 0
+              ).toString() : void 0
+            };
           }
-        } catch (e) {
-          const error = e;
-          const logMessage = `Error in nested key: ${error.message}`;
-          this.logger.debug(logMessage);
+          return {
+            ...commonFeeData,
+            feeType: "ROYALTY_FEE",
+            royaltyFee: {
+              numerator: Long.fromValue(
+                fee.royaltyFee.exchangeValueFraction?.numerator || 0
+              ).toString(),
+              denominator: Long.fromValue(
+                fee.royaltyFee.exchangeValueFraction?.denominator || 1
+              ).toString(),
+              fallbackFee: fallbackFeeData
+            }
+          };
         }
-      }
-    }
-    return false;
+        return {
+          ...commonFeeData,
+          feeType: "FIXED_FEE",
+          fixedFee: { amount: "0" }
+        };
+      });
+    }
+    return data;
   }
-  /**
-   * Compares an Ed25519 key with a user's public key.
-   * @param keyData The Ed25519 key data to compare.
-   * @param userPublicKey The public key of the user to compare with.
-   * @returns A boolean indicating whether the key matches the user's public key.
-   */
-  compareEd25519Key(keyData, userPublicKey) {
-    try {
-      const decodedKey = PublicKey.fromBytes(Buffer.from(keyData));
-      return decodedKey.toString() === userPublicKey.toString();
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error comparing Ed25519 key: ${error.message}`;
-      this.logger.debug(logMessage);
-      return false;
-    }
+  static parseTokenFreeze(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    return data;
   }
-  /**
-   * Retrieves information about a scheduled transaction
-   * @param scheduleId The ID of the scheduled transaction
-   * @returns A promise that resolves to the scheduled transaction information
-   */
-  async getScheduleInfo(scheduleId) {
-    try {
-      this.logger.info(
-        `Getting information for scheduled transaction ${scheduleId}`
-      );
-      const data = await this._requestWithRetry(
-        `/api/v1/schedules/${scheduleId}`
-      );
-      if (data) {
-        return data;
-      }
-      this.logger.warn(
-        `No schedule info found for ${scheduleId} after retries.`
-      );
-      return null;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching schedule info for ${scheduleId} after retries: ${error.message}`
-      );
-      return null;
-    }
+  static parseTokenUnfreeze(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    return data;
   }
-  /**
-   * Checks the status of a scheduled transaction
-   * @param scheduleId The schedule ID to check
-   * @returns Status of the scheduled transaction
-   */
-  async getScheduledTransactionStatus(scheduleId) {
-    try {
-      this.logger.info(
-        `Checking status of scheduled transaction ${scheduleId}`
-      );
-      const scheduleInfo = await this.getScheduleInfo(scheduleId);
-      if (!scheduleInfo) {
-        throw new Error(`Schedule ${scheduleId} not found`);
-      }
-      return {
-        executed: Boolean(scheduleInfo.executed_timestamp),
-        executedDate: scheduleInfo.executed_timestamp ? new Date(Number(scheduleInfo.executed_timestamp) * 1e3) : void 0,
-        deleted: scheduleInfo.deleted || false
-      };
-    } catch (error) {
-      this.logger.error(
-        `Error checking scheduled transaction status: ${error}`
+  static parseTokenGrantKyc(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseTokenRevokeKyc(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseTokenPause(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseTokenUnpause(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseTokenWipeAccount(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    if (body.serialNumbers && body.serialNumbers.length > 0) {
+      data.serialNumbers = body.serialNumbers.map(
+        (sn) => Long.fromValue(sn).toString()
       );
-      throw error;
     }
+    if (body.amount) {
+      data.amount = Long.fromValue(body.amount).toString();
+    }
+    return data;
   }
-  /**
-   * Retrieves details for a given transaction ID or hash from the mirror node.
-   * @param transactionIdOrHash The ID or hash of the transaction.
-   * @returns A promise that resolves to the transaction details.
-   * @throws An error if the transaction ID/hash is invalid or details cannot be retrieved.
-   */
-  async getTransaction(transactionIdOrHash) {
-    this.logger.info(
-      `Getting transaction details for ID/hash: ${transactionIdOrHash}`
-    );
-    try {
-      const response = await this._requestWithRetry(`/api/v1/transactions/${transactionIdOrHash}`);
-      if (response?.transactions?.length > 0) {
-        this.logger.trace(
-          `Transaction details found for ${transactionIdOrHash}:`,
-          response.transactions[0]
-        );
-        return response.transactions[0];
-      }
-      this.logger.warn(
-        `No transaction details found for ${transactionIdOrHash} or unexpected response structure.`
-      );
-      return null;
-    } catch (e) {
-      const error = e;
-      this.logger.error(
-        `Failed to get transaction details for ${transactionIdOrHash} after retries: ${error.message}`
+  static parseTokenDelete(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.token) {
+      data.tokenId = new TokenId(
+        body.token.shardNum ?? 0,
+        body.token.realmNum ?? 0,
+        body.token.tokenNum ?? 0
+      ).toString();
+    }
+    return data;
+  }
+  static parseTokenAssociate(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    if (body.tokens && body.tokens.length > 0) {
+      data.tokenIds = body.tokens.map(
+        (t) => new TokenId(
+          t.shardNum ?? 0,
+          t.realmNum ?? 0,
+          t.tokenNum ?? 0
+        ).toString()
       );
-      return null;
     }
+    return data;
   }
-  /**
-   * Private helper to make GET requests with retry logic using Axios.
-   */
-  async _requestWithRetry(endpoint, axiosConfig) {
-    let attempt = 0;
-    let delay = this.initialDelayMs;
-    const url = this.constructUrl(endpoint);
-    const config = {
-      ...axiosConfig,
-      headers: {
-        ...this.customHeaders,
-        ...axiosConfig?.headers
-      }
-    };
-    if (this.apiKey) {
-      config.headers = {
-        ...config.headers,
-        Authorization: `Bearer ${this.apiKey}`,
-        "X-API-Key": this.apiKey
-      };
-    }
-    while (attempt < this.maxRetries) {
-      try {
-        const response = await axios.get(url, config);
-        return response.data;
-      } catch (error) {
-        attempt++;
-        const isLastAttempt = attempt >= this.maxRetries;
-        const statusCode = error.response?.status;
-        if (statusCode && statusCode > 404 && statusCode < 500 && statusCode !== 429) {
-          this.logger.error(
-            `Client error for ${url} (status ${statusCode}): ${error.message}. Not retrying.`
-          );
-          throw error;
-        }
-        if (isLastAttempt) {
-          this.logger.error(
-            `Max retries (${this.maxRetries}) reached for ${url}. Last error: ${error.message}`
-          );
-          throw error;
-        }
-        this.logger.warn(
-          `Attempt ${attempt}/${this.maxRetries} failed for ${url}: ${error.message}. Retrying in ${delay}ms...`
-        );
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        delay = Math.min(delay * this.backoffFactor, this.maxDelayMs);
-      }
+  static parseTokenDissociate(body) {
+    if (!body) return void 0;
+    const data = {};
+    if (body.account) {
+      data.accountId = new AccountId(
+        body.account.shardNum ?? 0,
+        body.account.realmNum ?? 0,
+        body.account.accountNum ?? 0
+      ).toString();
+    }
+    if (body.tokens && body.tokens.length > 0) {
+      data.tokenIds = body.tokens.map(
+        (t) => new TokenId(
+          t.shardNum ?? 0,
+          t.realmNum ?? 0,
+          t.tokenNum ?? 0
+        ).toString()
+      );
     }
-    throw new Error(
-      `Failed to fetch data from ${url} after ${this.maxRetries} attempts.`
-    );
+    return data;
   }
   /**
-   * Private helper to make fetch requests with retry logic.
+   * Parse token airdrop transaction for both fungible tokens and NFTs
+   * Extracts airdrop transfers from transaction protobuf data
    */
-  async _fetchWithRetry(url, fetchOptions) {
-    let attempt = 0;
-    let delay = this.initialDelayMs;
-    const headers = {
-      ...this.customHeaders
-    };
-    if (fetchOptions?.headers) {
-      if (fetchOptions.headers instanceof Headers) {
-        fetchOptions.headers.forEach((value, key) => {
-          headers[key] = value;
-        });
-      } else if (Array.isArray(fetchOptions.headers)) {
-        fetchOptions.headers.forEach(([key, value]) => {
-          headers[key] = value;
-        });
-      } else {
-        Object.assign(headers, fetchOptions.headers);
+  static parseTokenAirdrop(transaction) {
+    try {
+      const transactionBody = transaction._transactionBody;
+      if (transactionBody?.tokenAirdrop) {
+        const airdrop = transactionBody.tokenAirdrop;
+        return {
+          tokenTransfers: (airdrop.tokenTransfers || []).map(
+            (transfer) => ({
+              tokenId: transfer.token?.toString() || "Unknown",
+              transfers: (transfer.transfers || []).map((t) => ({
+                accountId: t.accountID?.toString() || "Unknown",
+                amount: t.amount?.toString() || "0",
+                serialNumbers: t.serialNumbers?.map((sn) => sn.toString())
+              }))
+            })
+          )
+        };
       }
-    }
-    if (this.apiKey) {
-      headers["Authorization"] = `Bearer ${this.apiKey}`;
-      headers["X-API-Key"] = this.apiKey;
-    }
-    const options = {
-      ...fetchOptions,
-      headers
-    };
-    while (attempt < this.maxRetries) {
-      try {
-        const request = await fetch(url, options);
-        if (!request.ok) {
-          if (request.status >= 400 && request.status < 500 && request.status !== 429) {
-            this.logger.error(
-              `Client error for ${url} (status ${request.status}): ${request.statusText}. Not retrying.`
-            );
-            throw new Error(
-              `Fetch failed with status ${request.status}: ${request.statusText} for URL: ${url}`
-            );
-          }
-          throw new Error(
-            `Fetch failed with status ${request.status}: ${request.statusText} for URL: ${url}`
-          );
-        }
-        const response = await request.json();
-        return response;
-      } catch (error) {
-        attempt++;
-        if (attempt >= this.maxRetries) {
-          this.logger.error(
-            `Max retries (${this.maxRetries}) reached for ${url}. Last error: ${error.message}`
-          );
-          throw error;
+      if (hasTransactionType(transaction, "tokenAirdrop")) {
+        const txBody = extractTransactionBody(transaction);
+        if (txBody?.tokenAirdrop) {
+          return this.parseTokenAirdropFromProto(txBody.tokenAirdrop);
         }
-        this.logger.warn(
-          `Attempt ${attempt}/${this.maxRetries} failed for ${url}: ${error.message}. Retrying in ${delay}ms...`
-        );
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        delay = Math.min(delay * this.backoffFactor, this.maxDelayMs);
       }
-    }
-    throw new Error(
-      `Failed to fetch data from ${url} after ${this.maxRetries} attempts.`
-    );
-  }
-  /**
-   * Retrieves the numerical balance (in HBAR) for a given account ID.
-   * @param accountId The ID of the account.
-   * @returns A promise that resolves to the HBAR balance or null if an error occurs.
-   */
-  async getAccountBalance(accountId) {
-    this.logger.info(`Getting balance for account ${accountId}`);
-    try {
-      const accountInfo = await this.requestAccount(accountId);
-      if (accountInfo && accountInfo.balance) {
-        const hbarBalance = accountInfo.balance.balance / 1e8;
-        return hbarBalance;
+      const tx = transaction;
+      const tokenTransfersList = tx._tokenTransfers || [];
+      if (tokenTransfersList.length > 0) {
+        return {
+          tokenTransfers: tokenTransfersList.map((transfer) => ({
+            tokenId: transfer.tokenId?.toString() || "Unknown",
+            transfers: (transfer.transfers || []).map((t) => ({
+              accountId: t.accountId?.toString() || "Unknown",
+              amount: t.amount?.toString() || "0",
+              serialNumbers: t.serialNumbers?.map((sn) => sn.toString())
+            }))
+          }))
+        };
       }
-      this.logger.warn(
-        `Could not retrieve balance for account ${accountId} from account info.`
-      );
       return null;
     } catch (error) {
-      this.logger.error(
-        `Error fetching numerical balance for account ${accountId}: ${error.message}`
-      );
+      console.warn("[HTSParser] Failed to parse token airdrop:", error);
       return null;
     }
   }
   /**
-   * Retrieves messages for a given topic ID with optional filters.
-   * @param topicId The ID of the topic.
-   * @param sequenceNumber Filter by sequence number (e.g., "gt:10", "lte:20").
-   * @param startTime Filter by consensus timestamp (e.g., "gt:1629400000.000000000").
-   * @param endTime Filter by consensus timestamp (e.g., "lt:1629500000.000000000").
-   * @param limit The maximum number of messages to return.
-   * @returns A promise that resolves to an array of HCSMessages or null.
+   * Parse token airdrop from protobuf data for scheduled transactions
    */
-  async getTopicMessagesByFilter(topicId, options) {
-    this.logger.trace(
-      `Querying messages for topic ${topicId} with filters: ${JSON.stringify(
-        options
-      )}`
-    );
-    let nextUrl = `/api/v1/topics/${topicId}/messages`;
-    const params = new URLSearchParams();
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.sequenceNumber) {
-      params.append("sequencenumber", options.sequenceNumber);
-    }
-    if (options?.startTime) {
-      params.append("timestamp", `gte:${options.startTime}`);
-    }
-    if (options?.endTime) {
-      params.append("timestamp", `lt:${options.endTime}`);
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      nextUrl += `?${queryString}`;
-    }
-    const messages = [];
-    let pagesFetched = 0;
-    const maxPages = 10;
-    try {
-      while (nextUrl && pagesFetched < maxPages) {
-        pagesFetched++;
-        const data = await this._requestWithRetry(nextUrl);
-        if (data.messages && data.messages.length > 0) {
-          for (const message of data.messages) {
-            try {
-              if (!message.message) {
-                continue;
-              }
-              let messageContent;
-              if (this.isServerEnvironment) {
-                messageContent = Buffer.from(
-                  message.message,
-                  "base64"
-                ).toString("utf-8");
-              } else {
-                messageContent = new TextDecoder().decode(
-                  Uint8Array.from(atob(message.message), (c) => c.charCodeAt(0))
-                );
-              }
-              let messageJson = {};
-              try {
-                messageJson = JSON.parse(messageContent);
-              } catch (parseError) {
-                this.logger.debug(
-                  `Message content is not valid JSON, using raw: ${messageContent}`
-                );
-                messageJson = { raw_content: messageContent };
-              }
-              const parsedContent = messageJson;
-              const hcsMsg = {
-                ...parsedContent,
-                consensus_timestamp: message.consensus_timestamp,
-                sequence_number: message.sequence_number,
-                payer_account_id: message.payer_account_id,
-                topic_id: message.topic_id,
-                running_hash: message.running_hash,
-                running_hash_version: message.running_hash_version,
-                chunk_info: message.chunk_info,
-                created: new Date(
-                  Number(message.consensus_timestamp.split(".")[0]) * 1e3 + Number(message.consensus_timestamp.split(".")[1] || 0) / 1e6
-                ),
-                payer: message.payer_account_id
-              };
-              messages.push(hcsMsg);
-            } catch (error) {
-              this.logger.error(
-                `Error processing individual message: ${error.message}`
-              );
-            }
+  static parseTokenAirdropFromProto(airdrop) {
+    const tokenTransfers = [];
+    if (airdrop.tokenTransfers) {
+      for (const tokenTransfer of airdrop.tokenTransfers) {
+        const token = tokenTransfer.token ? new TokenId(
+          tokenTransfer.token.shardNum ?? 0,
+          tokenTransfer.token.realmNum ?? 0,
+          tokenTransfer.token.tokenNum ?? 0
+        ) : null;
+        const transfers = [];
+        if (tokenTransfer.transfers) {
+          for (const transfer of tokenTransfer.transfers) {
+            const accountId = transfer.accountID ? new AccountId(
+              transfer.accountID.shardNum ?? 0,
+              transfer.accountID.realmNum ?? 0,
+              transfer.accountID.accountNum ?? 0
+            ) : null;
+            transfers.push({
+              accountId: accountId?.toString() || "Unknown",
+              amount: transfer.amount ? Long.fromValue(transfer.amount).toString() : "0",
+              serialNumbers: transfer.serialNumbers?.map(
+                (sn) => Long.fromValue(sn).toString()
+              )
+            });
           }
         }
-        if (options?.limit && messages.length >= options.limit) break;
-        nextUrl = data.links?.next ? `${data.links.next}` : "";
+        tokenTransfers.push({
+          tokenId: token?.toString() || "Unknown",
+          transfers
+        });
       }
-      return messages;
-    } catch (e) {
-      const error = e;
-      this.logger.error(
-        `Error querying filtered topic messages for ${topicId}: ${error.message}`
-      );
-      return null;
     }
+    return { tokenTransfers };
   }
   /**
-   * Retrieves token balances for a given account ID.
-   * @param accountId The ID of the account.
-   * @param limit The maximum number of tokens to return.
-   * @returns A promise that resolves to an array of AccountTokenBalance or null.
+   * Extract token creation data from Transaction object internal fields
+   * This handles the case where token creation data is stored in Transaction internals
    */
-  async getAccountTokens(accountId, limit = 100) {
-    this.logger.info(`Getting tokens for account ${accountId}`);
-    let allTokens = [];
-    let endpoint = `/api/v1/accounts/${accountId}/tokens?limit=${limit}`;
+  static extractTokenCreationFromTransaction(transaction) {
     try {
-      for (let i = 0; i < 10 && endpoint; i++) {
-        const response = await this._requestWithRetry(endpoint);
-        if (response && response.tokens) {
-          allTokens = allTokens.concat(response.tokens);
+      const tx = transaction;
+      if (tx._tokenName || tx._tokenSymbol) {
+        const result = {
+          tokenName: tx._tokenName || "Unknown Token",
+          tokenSymbol: tx._tokenSymbol || "UNKNOWN",
+          initialSupply: tx._initialSupply?.toString() || "0",
+          decimals: Number(tx._decimals || 0),
+          treasuryAccountId: tx._treasuryAccountId?.toString() || "Unknown"
+        };
+        if (tx._maxSupply) {
+          result.maxSupply = tx._maxSupply.toString();
         }
-        endpoint = response.links?.next || "";
-        if (!endpoint || limit && allTokens.length >= limit) {
-          if (limit && allTokens.length > limit) {
-            allTokens = allTokens.slice(0, limit);
-          }
-          break;
+        if (tx._tokenType) {
+          result.tokenType = tx._tokenType.toString ? tx._tokenType.toString() : String(tx._tokenType);
         }
-      }
-      return allTokens;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching tokens for account ${accountId}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves transaction details by consensus timestamp.
-   * @param timestamp The consensus timestamp of the transaction (e.g., "1629400000.000000000").
-   * @returns A promise that resolves to the transaction details or null.
-   */
-  async getTransactionByTimestamp(timestamp) {
-    this.logger.info(`Getting transaction by timestamp: ${timestamp}`);
-    try {
-      const response = await this._requestWithRetry(`/api/v1/transactions?timestamp=${timestamp}&limit=1`);
-      return response.transactions;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching transaction by timestamp ${timestamp}: ${error}`
-      );
-      return [];
-    }
-  }
-  /**
-   * Retrieves NFTs for a given account ID, optionally filtered by token ID.
-   * @param accountId The ID of the account.
-   * @param tokenId Optional ID of the token to filter NFTs by.
-   * @param limit The maximum number of NFTs to return per page (API has its own max).
-   * @returns A promise that resolves to an array of NftDetail or null.
-   */
-  async getAccountNfts(accountId, tokenId, limit = 100) {
-    this.logger.info(
-      `Getting NFTs for account ${accountId}${tokenId ? ` for token ${tokenId}` : ""}`
-    );
-    let allNfts = [];
-    let endpoint = `/api/v1/accounts/${accountId}/nfts?limit=${limit}`;
-    if (tokenId) {
-      endpoint += `&token.id=${tokenId}`;
-    }
-    try {
-      for (let i = 0; i < 10 && endpoint; i++) {
-        const response = await this._requestWithRetry(endpoint);
-        if (response && response.nfts) {
-          const nftsWithUri = response.nfts.map((nft) => {
-            let tokenUri = void 0;
-            if (nft.metadata) {
-              try {
-                if (this.isServerEnvironment) {
-                  tokenUri = Buffer.from(nft.metadata, "base64").toString(
-                    "utf-8"
-                  );
-                } else {
-                  tokenUri = new TextDecoder().decode(
-                    Uint8Array.from(atob(nft.metadata), (c) => c.charCodeAt(0))
-                  );
-                }
-              } catch (e) {
-                this.logger.warn(
-                  `Failed to decode metadata for NFT ${nft.token_id} SN ${nft.serial_number}: ${e.message}`
-                );
-              }
+        if (tx._supplyType) {
+          result.supplyType = tx._supplyType.toString ? tx._supplyType.toString() : String(tx._supplyType);
+        }
+        if (tx._tokenMemo) {
+          result.memo = tx._tokenMemo;
+        }
+        if (tx._adminKey) {
+          result.adminKey = tx._adminKey.toString();
+        }
+        if (tx._kycKey) {
+          result.kycKey = tx._kycKey.toString();
+        }
+        if (tx._freezeKey) {
+          result.freezeKey = tx._freezeKey.toString();
+        }
+        if (tx._wipeKey) {
+          result.wipeKey = tx._wipeKey.toString();
+        }
+        if (tx._supplyKey) {
+          result.supplyKey = tx._supplyKey.toString();
+        }
+        if (tx._feeScheduleKey) {
+          result.feeScheduleKey = tx._feeScheduleKey.toString();
+        }
+        if (tx._pauseKey) {
+          result.pauseKey = tx._pauseKey.toString();
+        }
+        if (tx._metadataKey) {
+          result.metadataKey = tx._metadataKey.toString();
+        }
+        if (tx._autoRenewAccountId) {
+          result.autoRenewAccount = tx._autoRenewAccountId.toString();
+        }
+        if (tx._autoRenewPeriod) {
+          result.autoRenewPeriod = tx._autoRenewPeriod.seconds?.toString() || tx._autoRenewPeriod.toString();
+        }
+        if (tx._expirationTime) {
+          result.expiry = tx._expirationTime.seconds?.toString() || tx._expirationTime.toString();
+        }
+        if (tx._customFees && Array.isArray(tx._customFees) && tx._customFees.length > 0) {
+          result.customFees = tx._customFees.map((fee) => {
+            const customFee = {
+              feeCollectorAccountId: fee.feeCollectorAccountId?.toString() || "",
+              feeType: "FIXED_FEE"
+            };
+            if (fee.fixedFee) {
+              customFee.feeType = "FIXED_FEE";
+              customFee.fixedFee = {
+                amount: fee.fixedFee.amount?.toString() || "0",
+                denominatingTokenId: fee.fixedFee.denominatingTokenId?.toString()
+              };
+            } else if (fee.fractionalFee) {
+              customFee.feeType = "FRACTIONAL_FEE";
+              customFee.fractionalFee = {
+                numerator: fee.fractionalFee.numerator?.toString() || "0",
+                denominator: fee.fractionalFee.denominator?.toString() || "1",
+                minimumAmount: fee.fractionalFee.minimumAmount?.toString() || "0",
+                maximumAmount: fee.fractionalFee.maximumAmount?.toString() || "0",
+                netOfTransfers: fee.fractionalFee.netOfTransfers || false
+              };
+            } else if (fee.royaltyFee) {
+              customFee.feeType = "ROYALTY_FEE";
+              customFee.royaltyFee = {
+                numerator: fee.royaltyFee.numerator?.toString() || "0",
+                denominator: fee.royaltyFee.denominator?.toString() || "1",
+                fallbackFee: fee.royaltyFee.fallbackFee ? {
+                  amount: fee.royaltyFee.fallbackFee.amount?.toString() || "0",
+                  denominatingTokenId: fee.royaltyFee.fallbackFee.denominatingTokenId?.toString()
+                } : void 0
+              };
             }
-            return { ...nft, token_uri: tokenUri };
+            customFee.allCollectorsAreExempt = fee.allCollectorsAreExempt || false;
+            return customFee;
           });
-          allNfts = allNfts.concat(nftsWithUri);
         }
-        endpoint = response.links?.next || "";
-        if (!endpoint) break;
+        return result;
       }
-      return allNfts;
+      return null;
     } catch (error) {
-      this.logger.error(
-        `Error fetching NFTs for account ${accountId}: ${error.message}`
-      );
       return null;
     }
   }
   /**
-   * Validates NFT ownership by checking if a specific serial number of a token ID exists for an account.
-   * @param accountId The ID of the account.
-   * @param tokenId The ID of the NFT's token.
-   * @param serialNumber The serial number of the NFT.
-   * @returns A promise that resolves to the NftDetail if owned, or null otherwise.
+   * Extract token airdrop data from Transaction object internal fields
+   * This handles the case where airdrop data is stored in Transaction internals
    */
-  async validateNFTOwnership(accountId, tokenId, serialNumber) {
-    this.logger.info(
-      `Validating ownership of NFT ${tokenId} SN ${serialNumber} for account ${accountId}`
-    );
+  static extractTokenAirdropFromTransaction(transaction) {
     try {
-      const nfts = await this.getAccountNfts(accountId, tokenId);
-      if (nfts) {
-        const foundNft = nfts.find(
-          (nft) => nft.token_id === tokenId && nft.serial_number === serialNumber
-        );
-        return foundNft || null;
+      const tx = transaction;
+      if (tx._tokenAirdrops && Array.isArray(tx._tokenAirdrops)) {
+        const tokenTransfers = tx._tokenAirdrops.map((airdrop) => ({
+          tokenId: airdrop.tokenId?.toString() || "Unknown",
+          transfers: (airdrop.transfers || []).map((transfer) => ({
+            accountId: transfer.accountId?.toString() || "Unknown",
+            amount: transfer.amount?.toString() || "0",
+            serialNumbers: transfer.serialNumbers?.map((s) => s.toString()) || []
+          }))
+        }));
+        return { tokenTransfers };
       }
       return null;
     } catch (error) {
-      this.logger.error(`Error validating NFT ownership: ${error.message}`);
       return null;
     }
   }
   /**
-   * Performs a read-only query against a smart contract (eth_call like).
-   * @param contractIdOrAddress The contract ID (e.g., "0.0.123") or EVM address (e.g., "0x...").
-   * @param functionSelector The function selector and encoded parameters (e.g., "0xabcdef12...").
-   * @param payerAccountId The account ID of the payer (not strictly payer for read-only, but often required as 'from').
-   * @param estimate Whether this is an estimate call. Mirror node might not support this directly in /contracts/call for true estimation.
-   * @param block Block parameter, e.g., "latest", "pending", or block number.
-   * @param value The value in tinybars to send with the call (for payable view/pure functions, usually 0).
-   * @returns A promise that resolves to the contract call query response or null.
+   * Parse HTS transaction from Transaction object with comprehensive extraction
+   * This is the unified entry point that handles both protobuf and internal field extraction
    */
-  async readSmartContractQuery(contractIdOrAddress, functionSelector, payerAccountId, options) {
-    this.logger.info(
-      `Reading smart contract ${contractIdOrAddress} with selector ${functionSelector}`
-    );
-    const toAddress = contractIdOrAddress.startsWith("0x") ? contractIdOrAddress : `0x${AccountId.fromString(contractIdOrAddress).toSolidityAddress()}`;
-    const fromAddress = payerAccountId.startsWith("0x") ? payerAccountId : `0x${AccountId.fromString(payerAccountId).toSolidityAddress()}`;
-    const body = {
-      block: options?.block || "latest",
-      data: functionSelector,
-      estimate: options?.estimate || false,
-      from: fromAddress,
-      to: toAddress,
-      gas: options?.gas,
-      gasPrice: options?.gasPrice,
-      value: options?.value || 0
-    };
-    Object.keys(body).forEach((key) => {
-      const K = key;
-      if (body[K] === void 0) {
-        delete body[K];
-      }
-    });
+  static parseFromTransactionObject(transaction) {
     try {
-      const url = this.constructUrl("/api/v1/contracts/call");
-      const response = await this._fetchWithRetry(
-        url,
-        {
-          method: "POST",
-          body: JSON.stringify(body),
-          headers: {
-            "Content-Type": "application/json"
+      try {
+        const bytes = transaction.toBytes ? transaction.toBytes() : void 0;
+        if (bytes) {
+          const decoded = proto.TransactionList.decode(bytes);
+          if (decoded.transactionList && decoded.transactionList.length > 0) {
+            const tx = decoded.transactionList[0];
+            let txBody = null;
+            if (tx.bodyBytes && tx.bodyBytes.length > 0) {
+              txBody = proto.TransactionBody.decode(tx.bodyBytes);
+            } else if (tx.signedTransactionBytes && tx.signedTransactionBytes.length > 0) {
+              const signedTx = proto.SignedTransaction.decode(
+                tx.signedTransactionBytes
+              );
+              if (signedTx.bodyBytes) {
+                txBody = proto.TransactionBody.decode(signedTx.bodyBytes);
+              }
+            }
+            if (txBody) {
+              if (txBody.tokenCreation) {
+                const tokenCreation2 = this.parseTokenCreate(
+                  txBody.tokenCreation
+                );
+                if (tokenCreation2) {
+                  return {
+                    type: "TOKENCREATE",
+                    humanReadableType: "Token Creation",
+                    tokenCreation: tokenCreation2
+                  };
+                }
+              }
+              if (txBody.tokenMint) {
+                const tokenMint = this.parseTokenMint(txBody.tokenMint);
+                if (tokenMint) {
+                  return {
+                    type: "TOKENMINT",
+                    humanReadableType: "Token Mint",
+                    tokenMint
+                  };
+                }
+              }
+              if (txBody.tokenBurn) {
+                const tokenBurn = this.parseTokenBurn(txBody.tokenBurn);
+                if (tokenBurn) {
+                  return {
+                    type: "TOKENBURN",
+                    humanReadableType: "Token Burn",
+                    tokenBurn
+                  };
+                }
+              }
+              if (txBody.tokenUpdate) {
+                const tokenUpdate = this.parseTokenUpdate(txBody.tokenUpdate);
+                if (tokenUpdate) {
+                  return {
+                    type: "TOKENUPDATE",
+                    humanReadableType: "Token Update",
+                    tokenUpdate
+                  };
+                }
+              }
+              if (txBody.tokenFreeze) {
+                const tokenFreeze = this.parseTokenFreeze(txBody.tokenFreeze);
+                if (tokenFreeze) {
+                  return {
+                    type: "TOKENFREEZE",
+                    humanReadableType: "Token Freeze",
+                    tokenFreeze
+                  };
+                }
+              }
+              if (txBody.tokenUnfreeze) {
+                const tokenUnfreeze = this.parseTokenUnfreeze(
+                  txBody.tokenUnfreeze
+                );
+                if (tokenUnfreeze) {
+                  return {
+                    type: "TOKENUNFREEZE",
+                    humanReadableType: "Token Unfreeze",
+                    tokenUnfreeze
+                  };
+                }
+              }
+              if (txBody.tokenGrantKyc) {
+                const tokenGrantKyc = this.parseTokenGrantKyc(
+                  txBody.tokenGrantKyc
+                );
+                if (tokenGrantKyc) {
+                  return {
+                    type: "TOKENGRANTKYC",
+                    humanReadableType: "Token Grant KYC",
+                    tokenGrantKyc
+                  };
+                }
+              }
+              if (txBody.tokenRevokeKyc) {
+                const tokenRevokeKyc = this.parseTokenRevokeKyc(
+                  txBody.tokenRevokeKyc
+                );
+                if (tokenRevokeKyc) {
+                  return {
+                    type: "TOKENREVOKEKYC",
+                    humanReadableType: "Token Revoke KYC",
+                    tokenRevokeKyc
+                  };
+                }
+              }
+              if (txBody.tokenPause) {
+                const tokenPause = this.parseTokenPause(txBody.tokenPause);
+                if (tokenPause) {
+                  return {
+                    type: "TOKENPAUSE",
+                    humanReadableType: "Token Pause",
+                    tokenPause
+                  };
+                }
+              }
+              if (txBody.tokenUnpause) {
+                const tokenUnpause = this.parseTokenUnpause(
+                  txBody.tokenUnpause
+                );
+                if (tokenUnpause) {
+                  return {
+                    type: "TOKENUNPAUSE",
+                    humanReadableType: "Token Unpause",
+                    tokenUnpause
+                  };
+                }
+              }
+              if (txBody.tokenWipe) {
+                const tokenWipeAccount = this.parseTokenWipeAccount(
+                  txBody.tokenWipe
+                );
+                if (tokenWipeAccount) {
+                  return {
+                    type: "TOKENWIPEACCOUNT",
+                    humanReadableType: "Token Wipe Account",
+                    tokenWipeAccount
+                  };
+                }
+              }
+              if (txBody.tokenDeletion) {
+                const tokenDelete = this.parseTokenDelete(txBody.tokenDeletion);
+                if (tokenDelete) {
+                  return {
+                    type: "TOKENDELETE",
+                    humanReadableType: "Token Delete",
+                    tokenDelete
+                  };
+                }
+              }
+              if (txBody.tokenAssociate) {
+                const tokenAssociate = this.parseTokenAssociate(
+                  txBody.tokenAssociate
+                );
+                if (tokenAssociate) {
+                  return {
+                    type: "TOKENASSOCIATE",
+                    humanReadableType: "Token Associate",
+                    tokenAssociate
+                  };
+                }
+              }
+              if (txBody.tokenDissociate) {
+                const tokenDissociate = this.parseTokenDissociate(
+                  txBody.tokenDissociate
+                );
+                if (tokenDissociate) {
+                  return {
+                    type: "TOKENDISSOCIATE",
+                    humanReadableType: "Token Dissociate",
+                    tokenDissociate
+                  };
+                }
+              }
+              if (txBody.tokenFeeScheduleUpdate) {
+                const tokenFeeScheduleUpdate = this.parseTokenFeeScheduleUpdate(
+                  txBody.tokenFeeScheduleUpdate
+                );
+                if (tokenFeeScheduleUpdate) {
+                  return {
+                    type: "TOKENFEESCHEDULEUPDATE",
+                    humanReadableType: "Token Fee Schedule Update",
+                    tokenFeeScheduleUpdate
+                  };
+                }
+              }
+              if (txBody.tokenAirdrop) {
+                const tokenAirdrop2 = this.parseTokenAirdropFromProto(
+                  txBody.tokenAirdrop
+                );
+                if (tokenAirdrop2) {
+                  return {
+                    type: "TOKENAIRDROP",
+                    humanReadableType: "Token Airdrop",
+                    tokenAirdrop: tokenAirdrop2
+                  };
+                }
+              }
+            }
           }
         }
-      );
-      return response;
-    } catch (error) {
-      this.logger.error(
-        `Error reading smart contract ${contractIdOrAddress}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves outstanding token airdrops sent by an account.
-   * @param accountId The ID of the account that sent the airdrops.
-   * @param options Optional parameters for filtering airdrops.
-   * @returns A promise that resolves to an array of TokenAirdrop or null.
-   */
-  async getOutstandingTokenAirdrops(accountId, options) {
-    this.logger.info(
-      `Getting outstanding token airdrops sent by account ${accountId}`
-    );
-    let endpoint = `/api/v1/accounts/${accountId}/airdrops/outstanding`;
-    const params = new URLSearchParams();
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.receiverId) {
-      params.append("receiver.id", options.receiverId);
-    }
-    if (options?.serialNumber) {
-      params.append("serialnumber", options.serialNumber);
-    }
-    if (options?.tokenId) {
-      params.append("token.id", options.tokenId);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      endpoint += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(endpoint);
-      return response.airdrops || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching outstanding token airdrops for account ${accountId}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves pending token airdrops received by an account.
-   * @param accountId The ID of the account that received the airdrops.
-   * @param options Optional parameters for filtering airdrops.
-   * @returns A promise that resolves to an array of TokenAirdrop or null.
-   */
-  async getPendingTokenAirdrops(accountId, options) {
-    this.logger.info(
-      `Getting pending token airdrops received by account ${accountId}`
-    );
-    let endpoint = `/api/v1/accounts/${accountId}/airdrops/pending`;
-    const params = new URLSearchParams();
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.senderId) {
-      params.append("sender.id", options.senderId);
-    }
-    if (options?.serialNumber) {
-      params.append("serialnumber", options.serialNumber);
-    }
-    if (options?.tokenId) {
-      params.append("token.id", options.tokenId);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      endpoint += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(endpoint);
-      return response.airdrops || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching pending token airdrops for account ${accountId}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves blocks from the network.
-   * @param options Optional parameters for filtering blocks.
-   * @returns A promise that resolves to an array of Block or null.
-   */
-  async getBlocks(options) {
-    this.logger.info("Getting blocks from the network");
-    let endpoint = `/api/v1/blocks`;
-    const params = new URLSearchParams();
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    if (options?.blockNumber) {
-      params.append("block.number", options.blockNumber);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      endpoint += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(endpoint);
-      return response.blocks || [];
-    } catch (error) {
-      this.logger.error(`Error fetching blocks: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves a specific block by number or hash.
-   * @param blockNumberOrHash The block number or hash.
-   * @returns A promise that resolves to a Block or null.
-   */
-  async getBlock(blockNumberOrHash) {
-    this.logger.info(`Getting block ${blockNumberOrHash}`);
-    try {
-      const response = await this._requestWithRetry(
-        `/api/v1/blocks/${blockNumberOrHash}`
-      );
-      return response;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching block ${blockNumberOrHash}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract entities from the network.
-   * @param options Optional parameters for filtering contracts.
-   * @returns A promise that resolves to an array of ContractEntity or null.
-   */
-  async getContracts(options) {
-    this.logger.info("Getting contracts from the network");
-    let url = `/api/v1/contracts`;
-    const params = new URLSearchParams();
-    if (options?.contractId) {
-      params.append("contract.id", options.contractId);
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.contracts || [];
-    } catch (error) {
-      this.logger.error(`Error fetching contracts: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves a specific contract by ID or address.
-   * @param contractIdOrAddress The contract ID or EVM address.
-   * @param timestamp Optional timestamp for historical data.
-   * @returns A promise that resolves to a ContractEntity or null.
-   */
-  async getContract(contractIdOrAddress, timestamp) {
-    this.logger.info(`Getting contract ${contractIdOrAddress}`);
-    let url = `/api/v1/contracts/${contractIdOrAddress}`;
-    if (timestamp) {
-      url += `?timestamp=${timestamp}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract ${contractIdOrAddress}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract results from the network.
-   * @param options Optional parameters for filtering contract results.
-   * @returns A promise that resolves to an array of ContractResult or null.
-   */
-  async getContractResults(options) {
-    this.logger.info("Getting contract results from the network");
-    let url = `/api/v1/contracts/results`;
-    const params = new URLSearchParams();
-    if (options?.from) {
-      params.append("from", options.from);
-    }
-    if (options?.blockHash) {
-      params.append("block.hash", options.blockHash);
-    }
-    if (options?.blockNumber) {
-      params.append("block.number", options.blockNumber);
-    }
-    if (options?.internal !== void 0) {
-      params.append("internal", options.internal.toString());
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    if (options?.transactionIndex) {
-      params.append("transaction.index", options.transactionIndex.toString());
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.results || [];
-    } catch (error) {
-      this.logger.error(`Error fetching contract results: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves a specific contract result by transaction ID or hash.
-   * @param transactionIdOrHash The transaction ID or hash.
-   * @param nonce Optional nonce filter.
-   * @returns A promise that resolves to a ContractResult or null.
-   */
-  async getContractResult(transactionIdOrHash, nonce) {
-    this.logger.info(`Getting contract result for ${transactionIdOrHash}`);
-    let url = `/api/v1/contracts/results/${transactionIdOrHash}`;
-    if (nonce !== void 0) {
-      url += `?nonce=${nonce}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract result for ${transactionIdOrHash}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract results for a specific contract.
-   * @param contractIdOrAddress The contract ID or EVM address.
-   * @param options Optional parameters for filtering.
-   * @returns A promise that resolves to an array of ContractResult or null.
-   */
-  async getContractResultsByContract(contractIdOrAddress, options) {
-    this.logger.info(
-      `Getting contract results for contract ${contractIdOrAddress}`
-    );
-    let url = `/api/v1/contracts/${contractIdOrAddress}/results`;
-    const params = new URLSearchParams();
-    if (options?.blockHash) {
-      params.append("block.hash", options.blockHash);
-    }
-    if (options?.blockNumber) {
-      params.append("block.number", options.blockNumber);
-    }
-    if (options?.from) {
-      params.append("from", options.from);
-    }
-    if (options?.internal !== void 0) {
-      params.append("internal", options.internal.toString());
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    if (options?.transactionIndex) {
-      params.append("transaction.index", options.transactionIndex.toString());
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.results || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract results for ${contractIdOrAddress}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract state for a specific contract.
-   * @param contractIdOrAddress The contract ID or EVM address.
-   * @param options Optional parameters for filtering.
-   * @returns A promise that resolves to an array of ContractState or null.
-   */
-  async getContractState(contractIdOrAddress, options) {
-    this.logger.info(`Getting contract state for ${contractIdOrAddress}`);
-    let url = `/api/v1/contracts/${contractIdOrAddress}/state`;
-    const params = new URLSearchParams();
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.slot) {
-      params.append("slot", options.slot);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.state || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract state for ${contractIdOrAddress}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract actions for a specific transaction.
-   * @param transactionIdOrHash The transaction ID or hash.
-   * @param options Optional parameters for filtering.
-   * @returns A promise that resolves to an array of ContractAction or null.
-   */
-  async getContractActions(transactionIdOrHash, options) {
-    this.logger.info(`Getting contract actions for ${transactionIdOrHash}`);
-    let url = `/api/v1/contracts/results/${transactionIdOrHash}/actions`;
-    const params = new URLSearchParams();
-    if (options?.index) {
-      params.append("index", options.index);
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.actions || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract actions for ${transactionIdOrHash}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract logs from the network.
-   * @param options Optional parameters for filtering logs.
-   * @returns A promise that resolves to an array of ContractLog or null.
-   */
-  async getContractLogs(options) {
-    this.logger.info("Getting contract logs from the network");
-    let url = `/api/v1/contracts/results/logs`;
-    const params = new URLSearchParams();
-    if (options?.index) {
-      params.append("index", options.index);
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    if (options?.topic0) {
-      params.append("topic0", options.topic0);
-    }
-    if (options?.topic1) {
-      params.append("topic1", options.topic1);
-    }
-    if (options?.topic2) {
-      params.append("topic2", options.topic2);
-    }
-    if (options?.topic3) {
-      params.append("topic3", options.topic3);
-    }
-    if (options?.transactionHash) {
-      params.append("transaction.hash", options.transactionHash);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.logs || [];
-    } catch (error) {
-      this.logger.error(`Error fetching contract logs: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves contract logs for a specific contract.
-   * @param contractIdOrAddress The contract ID or EVM address.
-   * @param options Optional parameters for filtering logs.
-   * @returns A promise that resolves to an array of ContractLog or null.
-   */
-  async getContractLogsByContract(contractIdOrAddress, options) {
-    this.logger.info(
-      `Getting contract logs for contract ${contractIdOrAddress}`
-    );
-    let url = `/api/v1/contracts/${contractIdOrAddress}/results/logs`;
-    const params = new URLSearchParams();
-    if (options?.index) {
-      params.append("index", options.index);
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.timestamp) {
-      params.append("timestamp", options.timestamp);
-    }
-    if (options?.topic0) {
-      params.append("topic0", options.topic0);
-    }
-    if (options?.topic1) {
-      params.append("topic1", options.topic1);
-    }
-    if (options?.topic2) {
-      params.append("topic2", options.topic2);
-    }
-    if (options?.topic3) {
-      params.append("topic3", options.topic3);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.logs || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching contract logs for ${contractIdOrAddress}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves NFT information by token ID and serial number.
-   * @param tokenId The token ID.
-   * @param serialNumber The serial number of the NFT.
-   * @returns A promise that resolves to an NftInfo or null.
-   */
-  async getNftInfo(tokenId, serialNumber) {
-    this.logger.info(`Getting NFT info for ${tokenId}/${serialNumber}`);
-    const url = `/api/v1/tokens/${tokenId}/nfts/${serialNumber}`;
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(
-        `Error fetching NFT info for ${tokenId}/${serialNumber}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves NFTs for a specific token.
-   * @param tokenId The token ID.
-   * @param options Optional parameters for filtering NFTs.
-   * @returns A promise that resolves to an array of NftInfo or null.
-   */
-  async getNftsByToken(tokenId, options) {
-    this.logger.info(`Getting NFTs for token ${tokenId}`);
-    let url = `/api/v1/tokens/${tokenId}/nfts`;
-    const params = new URLSearchParams();
-    if (options?.accountId) {
-      params.append("account.id", options.accountId);
-    }
-    if (options?.limit) {
-      params.append("limit", options.limit.toString());
-    }
-    if (options?.order) {
-      params.append("order", options.order);
-    }
-    if (options?.serialNumber) {
-      params.append("serialnumber", options.serialNumber);
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response.nfts || [];
-    } catch (error) {
-      this.logger.error(
-        `Error fetching NFTs for token ${tokenId}: ${error.message}`
-      );
-      return null;
-    }
-  }
-  /**
-   * Retrieves network information.
-   * @returns A promise that resolves to NetworkInfo or null.
-   */
-  async getNetworkInfo() {
-    this.logger.info("Getting network information");
-    const url = `/api/v1/network/nodes`;
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(`Error fetching network info: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves network fees.
-   * @param timestamp Optional timestamp for historical fees.
-   * @returns A promise that resolves to NetworkFees or null.
-   */
-  async getNetworkFees(timestamp) {
-    this.logger.info("Getting network fees");
-    let url = `/api/v1/network/fees`;
-    if (timestamp) {
-      url += `?timestamp=${timestamp}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(`Error fetching network fees: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves network supply information.
-   * @param timestamp Optional timestamp for historical supply data.
-   * @returns A promise that resolves to NetworkSupply or null.
-   */
-  async getNetworkSupply(timestamp) {
-    this.logger.info("Getting network supply");
-    let url = `/api/v1/network/supply`;
-    if (timestamp) {
-      url += `?timestamp=${timestamp}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(`Error fetching network supply: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves network stake information.
-   * @param timestamp Optional timestamp for historical stake data.
-   * @returns A promise that resolves to NetworkStake or null.
-   */
-  async getNetworkStake(timestamp) {
-    this.logger.info("Getting network stake");
-    let url = `/api/v1/network/stake`;
-    if (timestamp) {
-      url += `?timestamp=${timestamp}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
-    } catch (error) {
-      this.logger.error(`Error fetching network stake: ${error.message}`);
-      return null;
-    }
-  }
-  /**
-   * Retrieves opcode traces for a specific transaction.
-   * @param transactionIdOrHash The transaction ID or hash.
-   * @param options Optional parameters for trace details.
-   * @returns A promise that resolves to an OpcodesResponse or null.
-   */
-  async getOpcodeTraces(transactionIdOrHash, options) {
-    this.logger.info(`Getting opcode traces for ${transactionIdOrHash}`);
-    let url = `/api/v1/contracts/results/${transactionIdOrHash}/opcodes`;
-    const params = new URLSearchParams();
-    if (options?.stack !== void 0) {
-      params.append("stack", options.stack.toString());
-    }
-    if (options?.memory !== void 0) {
-      params.append("memory", options.memory.toString());
-    }
-    if (options?.storage !== void 0) {
-      params.append("storage", options.storage.toString());
-    }
-    const queryString = params.toString();
-    if (queryString) {
-      url += `?${queryString}`;
-    }
-    try {
-      const response = await this._requestWithRetry(url);
-      return response;
+      } catch (e) {
+      }
+      const protoResult = this.parseHTSTransaction(transaction);
+      if (protoResult.type) {
+        return protoResult;
+      }
+      const tokenCreation = this.extractTokenCreationFromTransaction(transaction);
+      const tokenAirdrop = this.extractTokenAirdropFromTransaction(transaction);
+      if (tokenCreation) {
+        return {
+          type: "TOKENCREATE",
+          humanReadableType: "Token Creation",
+          tokenCreation
+        };
+      }
+      if (tokenAirdrop) {
+        return {
+          type: "TOKENAIRDROP",
+          humanReadableType: "Token Airdrop",
+          tokenAirdrop
+        };
+      }
+      return {};
     } catch (error) {
-      this.logger.error(
-        `Error fetching opcode traces for ${transactionIdOrHash}: ${error.message}`
-      );
-      return null;
+      return {};
     }
   }
 }
 export {
-  HederaMirrorNode
+  HTSParser
 };
 //# sourceMappingURL=standards-sdk.es120.js.map