@hashgraphonline/standards-sdk 0.0.112-canary.0 → 0.0.112-canary.2

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

@@ -105,10 +105,9 @@ class HederaMirrorNode {
    */
   async getAccountMemo(accountId) {
     this.logger.info(`Getting account memo for account ID: ${accountId}`);
-    const accountInfoUrl = this.constructUrl(`/api/v1/accounts/${accountId}`);
     try {
       const accountInfo = await this._requestWithRetry(
-        accountInfoUrl
+        `/api/v1/accounts/${accountId}`
       );
       if (accountInfo?.memo) {
         return accountInfo.memo;
@@ -131,9 +130,10 @@ class HederaMirrorNode {
    */
   async getTopicInfo(topicId) {
     try {
-      const topicInfoUrl = this.constructUrl(`/api/v1/topics/${topicId}`);
-      this.logger.debug(`Fetching topic info from ${topicInfoUrl}`);
-      const data = await this._requestWithRetry(topicInfoUrl);
+      this.logger.debug(`Fetching topic info for ${topicId}`);
+      const data = await this._requestWithRetry(
+        `/api/v1/topics/${topicId}`
+      );
       return data;
     } catch (e) {
       const error = e;
@@ -168,9 +168,10 @@ class HederaMirrorNode {
   async getHBARPrice(date) {
     try {
       const timestamp = Timestamp.fromDate(date).toString();
-      const url = `https://mainnet-public.mirrornode.hedera.com/api/v1/network/exchangerate?timestamp=${timestamp}`;
-      this.logger.debug(`Fetching HBAR price from ${url}`);
-      const response = await this._fetchWithRetry(url);
+      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) {
@@ -189,9 +190,8 @@ class HederaMirrorNode {
   async getTokenInfo(tokenId) {
     this.logger.debug(`Fetching token info for ${tokenId}`);
     try {
-      const tokenInfoUrl = this.constructUrl(`/api/v1/tokens/${tokenId}`);
       const data = await this._requestWithRetry(
-        tokenInfoUrl
+        `/api/v1/tokens/${tokenId}`
       );
       if (data) {
         this.logger.trace(`Token info found for ${tokenId}:`, data);
@@ -214,12 +214,12 @@ class HederaMirrorNode {
    */
   async getTopicMessages(topicId) {
     this.logger.trace(`Querying messages for topic ${topicId}`);
-    let nextUrl = this.constructUrl(`/api/v1/topics/${topicId}/messages`);
+    let nextEndpoint = `/api/v1/topics/${topicId}/messages`;
     const messages = [];
-    while (nextUrl) {
+    while (nextEndpoint) {
       try {
         const data = await this._requestWithRetry(
-          nextUrl
+          nextEndpoint
         );
         if (data.messages && data.messages.length > 0) {
           for (const message of data.messages) {
@@ -268,10 +268,10 @@ class HederaMirrorNode {
             }
           }
         }
-        nextUrl = data.links?.next ? this.constructUrl(data.links.next) : "";
+        nextEndpoint = data.links?.next || "";
       } catch (e) {
         const error = e;
-        const logMessage = `Error querying topic messages for topic ${topicId} (URL: ${nextUrl}) after retries: ${error.message}`;
+        const logMessage = `Error querying topic messages for topic ${topicId} (endpoint: ${nextEndpoint}) after retries: ${error.message}`;
         this.logger.error(logMessage);
         throw new Error(logMessage);
       }
@@ -286,10 +286,9 @@ class HederaMirrorNode {
    */
   async requestAccount(accountId) {
     try {
-      const accountInfoUrl = this.constructUrl(`/api/v1/accounts/${accountId}`);
-      this.logger.debug(`Requesting account info from ${accountInfoUrl}`);
+      this.logger.debug(`Requesting account info for ${accountId}`);
       const data = await this._requestWithRetry(
-        accountInfoUrl
+        `/api/v1/accounts/${accountId}`
       );
       if (!data) {
         throw new Error(
@@ -402,8 +401,9 @@ class HederaMirrorNode {
       this.logger.info(
         `Getting information for scheduled transaction ${scheduleId}`
       );
-      const url = `${this.baseUrl}/api/v1/schedules/${scheduleId}`;
-      const data = await this._requestWithRetry(url);
+      const data = await this._requestWithRetry(
+        `/api/v1/schedules/${scheduleId}`
+      );
       if (data) {
         return data;
       }
@@ -454,10 +454,8 @@ class HederaMirrorNode {
     this.logger.info(
       `Getting transaction details for ID/hash: ${transactionIdOrHash}`
     );
-    const endpoint = transactionIdOrHash.includes("-") ? `transactions/${transactionIdOrHash}` : `transactions/${transactionIdOrHash}`;
-    const transactionDetailsUrl = `${this.baseUrl}/api/v1/${endpoint}`;
     try {
-      const response = await this._requestWithRetry(transactionDetailsUrl);
+      const response = await this._requestWithRetry(`/api/v1/transactions/${transactionIdOrHash}`);
       if (response?.transactions?.length > 0) {
         this.logger.trace(
           `Transaction details found for ${transactionIdOrHash}:`,
@@ -480,9 +478,10 @@ class HederaMirrorNode {
   /**
    * Private helper to make GET requests with retry logic using Axios.
    */
-  async _requestWithRetry(url, axiosConfig) {
+  async _requestWithRetry(endpoint, axiosConfig) {
     let attempt = 0;
     let delay = this.initialDelayMs;
+    const url = this.constructUrl(endpoint);
     const config = {
       ...axiosConfig,
       headers: {
@@ -634,7 +633,7 @@ class HederaMirrorNode {
         options
       )}`
     );
-    let nextUrl = `${this.baseUrl}/api/v1/topics/${topicId}/messages`;
+    let nextUrl = `/api/v1/topics/${topicId}/messages`;
     const params = new URLSearchParams();
     if (options?.limit) {
       params.append("limit", options.limit.toString());
@@ -714,7 +713,7 @@ class HederaMirrorNode {
           }
         }
         if (options?.limit && messages.length >= options.limit) break;
-        nextUrl = data.links?.next ? `${this.baseUrl}${data.links.next}` : "";
+        nextUrl = data.links?.next ? `${data.links.next}` : "";
       }
       return messages;
     } catch (e) {
@@ -734,17 +733,17 @@ class HederaMirrorNode {
   async getAccountTokens(accountId, limit = 100) {
     this.logger.info(`Getting tokens for account ${accountId}`);
     let allTokens = [];
-    let url = `${this.baseUrl}/api/v1/accounts/${accountId}/tokens?limit=${limit}`;
+    let endpoint = `/api/v1/accounts/${accountId}/tokens?limit=${limit}`;
     try {
-      for (let i = 0; i < 10 && url; i++) {
+      for (let i = 0; i < 10 && endpoint; i++) {
         const response = await this._requestWithRetry(
-          url
+          endpoint
         );
         if (response && response.tokens) {
           allTokens = allTokens.concat(response.tokens);
         }
-        url = response.links?.next ? `${this.baseUrl}${response.links.next}` : "";
-        if (!url || limit && allTokens.length >= limit) {
+        endpoint = response.links?.next || "";
+        if (!endpoint || limit && allTokens.length >= limit) {
           if (limit && allTokens.length > limit) {
             allTokens = allTokens.slice(0, limit);
           }
@@ -766,9 +765,8 @@ class HederaMirrorNode {
    */
   async getTransactionByTimestamp(timestamp) {
     this.logger.info(`Getting transaction by timestamp: ${timestamp}`);
-    const url = `${this.baseUrl}/api/v1/transactions?timestamp=${timestamp}&limit=1`;
     try {
-      const response = await this._requestWithRetry(url);
+      const response = await this._requestWithRetry(`/api/v1/transactions?timestamp=${timestamp}&limit=1`);
       return response.transactions;
     } catch (error) {
       this.logger.error(
@@ -789,13 +787,15 @@ class HederaMirrorNode {
       `Getting NFTs for account ${accountId}${tokenId ? ` for token ${tokenId}` : ""}`
     );
     let allNfts = [];
-    let url = `${this.baseUrl}/api/v1/accounts/${accountId}/nfts?limit=${limit}`;
+    let endpoint = `/api/v1/accounts/${accountId}/nfts?limit=${limit}`;
     if (tokenId) {
-      url += `&token.id=${tokenId}`;
+      endpoint += `&token.id=${tokenId}`;
     }
     try {
-      for (let i = 0; i < 10 && url; i++) {
-        const response = await this._requestWithRetry(url);
+      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;
@@ -820,8 +820,8 @@ class HederaMirrorNode {
           });
           allNfts = allNfts.concat(nftsWithUri);
         }
-        url = response.links?.next ? `${this.baseUrl}${response.links.next}` : "";
-        if (!url) break;
+        endpoint = response.links?.next || "";
+        if (!endpoint) break;
       }
       return allNfts;
     } catch (error) {
@@ -870,7 +870,6 @@ class HederaMirrorNode {
     this.logger.info(
       `Reading smart contract ${contractIdOrAddress} with selector ${functionSelector}`
     );
-    const url = `${this.baseUrl}/api/v1/contracts/call`;
     const toAddress = contractIdOrAddress.startsWith("0x") ? contractIdOrAddress : `0x${AccountId.fromString(contractIdOrAddress).toSolidityAddress()}`;
     const fromAddress = payerAccountId.startsWith("0x") ? payerAccountId : `0x${AccountId.fromString(payerAccountId).toSolidityAddress()}`;
     const body = {
@@ -890,6 +889,7 @@ class HederaMirrorNode {
       }
     });
     try {
+      const url = this.constructUrl("/api/v1/contracts/call");
       const response = await this._fetchWithRetry(
         url,
         {
@@ -909,20 +909,87 @@ class HederaMirrorNode {
     }
   }
   /**
-   * Retrieves token airdrops for a given account ID.
-   * @param accountId The ID of the account to retrieve airdrops for.
-   * @param limit The maximum number of airdrops to return.
+   * 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 getTokenAirdrops(accountId, limit = 100) {
-    this.logger.info(`Getting token airdrops for account ${accountId}`);
-    const url = `${this.baseUrl}/api/v1/accounts/${accountId}/airdrops/tokens?limit=${limit}`;
+  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(url);
+      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 token airdrops for account ${accountId}: ${error.message}`
+        `Error fetching pending token airdrops for account ${accountId}: ${error.message}`
       );
       return null;
     }
@@ -934,7 +1001,7 @@ class HederaMirrorNode {
    */
   async getBlocks(options) {
     this.logger.info("Getting blocks from the network");
-    let url = `${this.baseUrl}/api/v1/blocks`;
+    let endpoint = `/api/v1/blocks`;
     const params = new URLSearchParams();
     if (options?.limit) {
       params.append("limit", options.limit.toString());
@@ -950,10 +1017,10 @@ class HederaMirrorNode {
     }
     const queryString = params.toString();
     if (queryString) {
-      url += `?${queryString}`;
+      endpoint += `?${queryString}`;
     }
     try {
-      const response = await this._requestWithRetry(url);
+      const response = await this._requestWithRetry(endpoint);
       return response.blocks || [];
     } catch (error) {
       this.logger.error(`Error fetching blocks: ${error.message}`);
@@ -967,9 +1034,10 @@ class HederaMirrorNode {
    */
   async getBlock(blockNumberOrHash) {
     this.logger.info(`Getting block ${blockNumberOrHash}`);
-    const url = `${this.baseUrl}/api/v1/blocks/${blockNumberOrHash}`;
     try {
-      const response = await this._requestWithRetry(url);
+      const response = await this._requestWithRetry(
+        `/api/v1/blocks/${blockNumberOrHash}`
+      );
       return response;
     } catch (error) {
       this.logger.error(
@@ -985,7 +1053,7 @@ class HederaMirrorNode {
    */
   async getContracts(options) {
     this.logger.info("Getting contracts from the network");
-    let url = `${this.baseUrl}/api/v1/contracts`;
+    let url = `/api/v1/contracts`;
     const params = new URLSearchParams();
     if (options?.contractId) {
       params.append("contract.id", options.contractId);
@@ -1016,7 +1084,7 @@ class HederaMirrorNode {
    */
   async getContract(contractIdOrAddress, timestamp) {
     this.logger.info(`Getting contract ${contractIdOrAddress}`);
-    let url = `${this.baseUrl}/api/v1/contracts/${contractIdOrAddress}`;
+    let url = `/api/v1/contracts/${contractIdOrAddress}`;
     if (timestamp) {
       url += `?timestamp=${timestamp}`;
     }
@@ -1037,7 +1105,7 @@ class HederaMirrorNode {
    */
   async getContractResults(options) {
     this.logger.info("Getting contract results from the network");
-    let url = `${this.baseUrl}/api/v1/contracts/results`;
+    let url = `/api/v1/contracts/results`;
     const params = new URLSearchParams();
     if (options?.from) {
       params.append("from", options.from);
@@ -1085,7 +1153,7 @@ class HederaMirrorNode {
    */
   async getContractResult(transactionIdOrHash, nonce) {
     this.logger.info(`Getting contract result for ${transactionIdOrHash}`);
-    let url = `${this.baseUrl}/api/v1/contracts/results/${transactionIdOrHash}`;
+    let url = `/api/v1/contracts/results/${transactionIdOrHash}`;
     if (nonce !== void 0) {
       url += `?nonce=${nonce}`;
     }
@@ -1109,7 +1177,7 @@ class HederaMirrorNode {
     this.logger.info(
       `Getting contract results for contract ${contractIdOrAddress}`
     );
-    let url = `${this.baseUrl}/api/v1/contracts/${contractIdOrAddress}/results`;
+    let url = `/api/v1/contracts/${contractIdOrAddress}/results`;
     const params = new URLSearchParams();
     if (options?.blockHash) {
       params.append("block.hash", options.blockHash);
@@ -1159,7 +1227,7 @@ class HederaMirrorNode {
    */
   async getContractState(contractIdOrAddress, options) {
     this.logger.info(`Getting contract state for ${contractIdOrAddress}`);
-    let url = `${this.baseUrl}/api/v1/contracts/${contractIdOrAddress}/state`;
+    let url = `/api/v1/contracts/${contractIdOrAddress}/state`;
     const params = new URLSearchParams();
     if (options?.limit) {
       params.append("limit", options.limit.toString());
@@ -1195,7 +1263,7 @@ class HederaMirrorNode {
    */
   async getContractActions(transactionIdOrHash, options) {
     this.logger.info(`Getting contract actions for ${transactionIdOrHash}`);
-    let url = `${this.baseUrl}/api/v1/contracts/results/${transactionIdOrHash}/actions`;
+    let url = `/api/v1/contracts/results/${transactionIdOrHash}/actions`;
     const params = new URLSearchParams();
     if (options?.index) {
       params.append("index", options.index);
@@ -1229,7 +1297,7 @@ class HederaMirrorNode {
    */
   async getContractLogs(options) {
     this.logger.info("Getting contract logs from the network");
-    let url = `${this.baseUrl}/api/v1/contracts/results/logs`;
+    let url = `/api/v1/contracts/results/logs`;
     const params = new URLSearchParams();
     if (options?.index) {
       params.append("index", options.index);
@@ -1280,7 +1348,7 @@ class HederaMirrorNode {
     this.logger.info(
       `Getting contract logs for contract ${contractIdOrAddress}`
     );
-    let url = `${this.baseUrl}/api/v1/contracts/${contractIdOrAddress}/results/logs`;
+    let url = `/api/v1/contracts/${contractIdOrAddress}/results/logs`;
     const params = new URLSearchParams();
     if (options?.index) {
       params.append("index", options.index);
@@ -1320,39 +1388,6 @@ class HederaMirrorNode {
       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 OpcodeTraceResponse or null.
-   */
-  async getOpcodeTraces(transactionIdOrHash, options) {
-    this.logger.info(`Getting opcode traces for ${transactionIdOrHash}`);
-    let url = `${this.baseUrl}/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 (error) {
-      this.logger.error(
-        `Error fetching opcode traces for ${transactionIdOrHash}: ${error.message}`
-      );
-      return null;
-    }
-  }
   /**
    * Retrieves NFT information by token ID and serial number.
    * @param tokenId The token ID.
@@ -1361,10 +1396,10 @@ class HederaMirrorNode {
    */
   async getNftInfo(tokenId, serialNumber) {
     this.logger.info(`Getting NFT info for ${tokenId}/${serialNumber}`);
-    const url = `${this.baseUrl}/api/v1/tokens/${tokenId}/nfts/${serialNumber}`;
+    const url = `/api/v1/tokens/${tokenId}/nfts/${serialNumber}`;
     try {
       const response = await this._requestWithRetry(url);
-      return response.nft;
+      return response;
     } catch (error) {
       this.logger.error(
         `Error fetching NFT info for ${tokenId}/${serialNumber}: ${error.message}`
@@ -1380,7 +1415,7 @@ class HederaMirrorNode {
    */
   async getNftsByToken(tokenId, options) {
     this.logger.info(`Getting NFTs for token ${tokenId}`);
-    let url = `${this.baseUrl}/api/v1/tokens/${tokenId}/nfts`;
+    let url = `/api/v1/tokens/${tokenId}/nfts`;
     const params = new URLSearchParams();
     if (options?.accountId) {
       params.append("account.id", options.accountId);
@@ -1414,7 +1449,7 @@ class HederaMirrorNode {
    */
   async getNetworkInfo() {
     this.logger.info("Getting network information");
-    const url = `${this.baseUrl}/api/v1/network/nodes`;
+    const url = `/api/v1/network/nodes`;
     try {
       const response = await this._requestWithRetry(url);
       return response;
@@ -1430,7 +1465,7 @@ class HederaMirrorNode {
    */
   async getNetworkFees(timestamp) {
     this.logger.info("Getting network fees");
-    let url = `${this.baseUrl}/api/v1/network/fees`;
+    let url = `/api/v1/network/fees`;
     if (timestamp) {
       url += `?timestamp=${timestamp}`;
     }
@@ -1449,7 +1484,7 @@ class HederaMirrorNode {
    */
   async getNetworkSupply(timestamp) {
     this.logger.info("Getting network supply");
-    let url = `${this.baseUrl}/api/v1/network/supply`;
+    let url = `/api/v1/network/supply`;
     if (timestamp) {
       url += `?timestamp=${timestamp}`;
     }
@@ -1468,7 +1503,7 @@ class HederaMirrorNode {
    */
   async getNetworkStake(timestamp) {
     this.logger.info("Getting network stake");
-    let url = `${this.baseUrl}/api/v1/network/stake`;
+    let url = `/api/v1/network/stake`;
     if (timestamp) {
       url += `?timestamp=${timestamp}`;
     }
@@ -1480,6 +1515,39 @@ class HederaMirrorNode {
       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 (error) {
+      this.logger.error(
+        `Error fetching opcode traces for ${transactionIdOrHash}: ${error.message}`
+      );
+      return null;
+    }
+  }
 }
 export {
   HederaMirrorNode