@covalenthq/client-sdk 0.2.9 → 0.5.0

package/dist/services/NftService.js

@@ -1,13 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NftService = void 0;
-const Client_1 = require("./Client");
-const ApiHelpers_1 = require("../util/ApiHelpers");
-const date_fns_1 = require("date-fns");
-const backoff_1 = require("../util/backoff");
+import { userAgent } from "./CovalentClient";
+import { checkAndModifyResponse, debugOutput, paginateEndpoint } from "../util/ApiHelpers";
+import { parseISO } from "date-fns";
+import { ExponentialBackoff } from "../util/backoff";
+import pLimit from "p-limit";
 class ChainCollectionResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new ChainCollectionItem(itemData)) : null;
@@ -22,7 +20,7 @@ class ChainCollectionItem {
         this.token_total_supply = data.token_total_supply;
         this.cached_metadata_count = data.cached_metadata_count;
         this.cached_asset_count = data.cached_asset_count;
-        this.last_scraped_at = data.last_scraped_at && data.last_scraped_at !== null ? (0, date_fns_1.parseISO)(data.last_scraped_at.toString()) : null;
+        this.last_scraped_at = data.last_scraped_at && data.last_scraped_at !== null ? parseISO(data.last_scraped_at.toString()) : null;
     }
 }
 class Pagination {
@@ -36,7 +34,7 @@ class Pagination {
 class NftAddressBalanceNftResponse {
     constructor(data) {
         this.address = data.address;
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftTokenContractBalanceItem(itemData)) : null;
     }
 }
@@ -47,9 +45,9 @@ class NftTokenContractBalanceItem {
         this.contract_address = data.contract_address;
         this.supports_erc = data.supports_erc;
         this.is_spam = data.is_spam;
-        this.last_transfered_at = data.last_transfered_at && data.last_transfered_at !== null ? (0, date_fns_1.parseISO)(data.last_transfered_at.toString()) : null;
+        this.last_transfered_at = data.last_transfered_at && data.last_transfered_at !== null ? parseISO(data.last_transfered_at.toString()) : null;
         this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
-        this.balance24h = data.balance24h;
+        this.balance_24h = data.balance_24h;
         this.type = data.type;
         this.nft_data = data.nft_data && data.nft_data !== null ? data.nft_data.map((itemData) => new NftData(itemData)) : null;
     }
@@ -89,7 +87,7 @@ class NftCollectionAttribute {
 }
 class NftMetadataResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftTokenContract(itemData)) : null;
         this.pagination = data.pagination && data.pagination !== null ? new Pagination(data.pagination) : null;
     }
@@ -106,7 +104,7 @@ class NftTokenContract {
 }
 class NftTransactionsResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftTransaction(itemData)) : null;
@@ -126,7 +124,7 @@ class NftTransaction {
 }
 class NftTransactionItem {
     constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? (0, date_fns_1.parseISO)(data.block_signed_at.toString()) : null;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
         this.block_height = data.block_height;
         this.tx_hash = data.tx_hash;
         this.tx_offset = data.tx_offset;
@@ -150,7 +148,7 @@ class NftTransactionItem {
 }
 class LogEvent {
     constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? (0, date_fns_1.parseISO)(data.block_signed_at.toString()) : null;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
         this.block_height = data.block_height;
         this.tx_offset = data.tx_offset;
         this.log_offset = data.log_offset;
@@ -184,7 +182,7 @@ class Param {
 }
 class NftCollectionTraitsResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftTrait(itemData)) : null;
     }
 }
@@ -195,7 +193,7 @@ class NftTrait {
 }
 class NftCollectionAttributesForTraitResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftSummaryAttribute(itemData)) : null;
     }
 }
@@ -214,7 +212,7 @@ class NftAttribute {
 }
 class NftCollectionTraitSummaryResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftTraitSummary(itemData)) : null;
     }
 }
@@ -242,7 +240,7 @@ class NftTraitString {
 }
 class NftOwnershipForCollectionResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.address = data.address;
         this.collection = data.collection;
         this.is_spam = data.is_spam;
@@ -256,22 +254,83 @@ class NftOwnershipForCollectionItem {
         this.contract_address = data.contract_address;
         this.token_id = data.token_id && data.token_id !== null ? BigInt(data.token_id) : null;
         this.supports_erc = data.supports_erc;
-        this.last_transfered_at = data.last_transfered_at && data.last_transfered_at !== null ? (0, date_fns_1.parseISO)(data.last_transfered_at.toString()) : null;
+        this.last_transfered_at = data.last_transfered_at && data.last_transfered_at !== null ? parseISO(data.last_transfered_at.toString()) : null;
         this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
-        this.balance24h = data.balance24h;
+        this.balance_24h = data.balance_24h;
         this.type = data.type;
         this.nft_data = data.nft_data && data.nft_data !== null ? new NftData(data.nft_data) : null;
     }
 }
+class NftMarketSaleCountResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketSaleCountItem(itemData)) : null;
+    }
+}
+class MarketSaleCountItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.sale_count = data.sale_count;
+    }
+}
+class NftMarketVolumeResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketVolumeItem(itemData)) : null;
+    }
+}
+class MarketVolumeItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.native_ticker_symbol = data.native_ticker_symbol;
+        this.native_name = data.native_name;
+        this.volume_quote = data.volume_quote;
+        this.volume_native_quote = data.volume_native_quote;
+        this.pretty_volume_quote = data.pretty_volume_quote;
+    }
+}
+class NftMarketFloorPriceResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketFloorPriceItem(itemData)) : null;
+    }
+}
+class MarketFloorPriceItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.native_ticker_symbol = data.native_ticker_symbol;
+        this.native_name = data.native_name;
+        this.floor_price_native_quote = data.floor_price_native_quote;
+        this.floor_price_quote = data.floor_price_quote;
+        this.pretty_floor_price_quote = data.pretty_floor_price_quote;
+    }
+}
 /**
  * NFT APIs
  *
  */
-class NftService {
-    constructor(apiKey) {
+export class NftService {
+    constructor(apiKey, debug = false, threadCount = 3) {
         this.apiKey = apiKey;
+        this.debug = debug;
+        this.threadCount = threadCount;
+        this.LIMIT = pLimit(this.threadCount);
     }
     /**
+     *
+     * Commonly used to fetch the list of NFT collections with downloaded and cached off chain data like token metadata and asset files.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {GetChainCollectionsQueryParamOpts} queryParamOpts
@@ -295,18 +354,20 @@ class NftService {
                 if (queryParamOpts?.noSpam !== undefined) {
                     urlParams.append("no-spam", queryParamOpts?.noSpam.toString());
                 }
-                for await (res of (0, ApiHelpers_1.paginateEndpoint)(`https://api.covalenthq.com/v1/${chainName}/nft/collections/`, this.apiKey, urlParams, ChainCollectionItem)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/nft/collections/`, this.apiKey, urlParams, ChainCollectionItem, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -320,7 +381,7 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
@@ -333,38 +394,43 @@ class NftService {
                 if (queryParamOpts?.withUncached !== undefined) {
                     urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_nft/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_nft/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftAddressBalanceNftResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftAddressBalanceNftResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -372,12 +438,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to get NFT token IDs with metadata from a collection. Useful for building NFT card displays.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -414,18 +482,20 @@ class NftService {
                 if (queryParamOpts?.withUncached !== undefined) {
                     urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
                 }
-                for await (res of (0, ApiHelpers_1.paginateEndpoint)(`https://api.covalenthq.com/v1/${chainName}/nft/${contractAddress}/metadata/`, this.apiKey, urlParams, NftTokenContract)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/nft/${contractAddress}/metadata/`, this.apiKey, urlParams, NftTokenContract, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * Commonly used to get a single NFT metadata by token ID from a collection. Useful for building NFT card displays.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -439,7 +509,7 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
@@ -449,38 +519,43 @@ class NftService {
                 if (queryParamOpts?.withUncached !== undefined) {
                     urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${contractAddress}/metadata/${tokenId}/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${contractAddress}/metadata/${tokenId}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftMetadataResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftMetadataResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -488,12 +563,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to get all transactions of an NFT token. Useful for building a transaction history table or price chart.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -506,45 +583,50 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
                 if (queryParamOpts?.noSpam !== undefined) {
                     urlParams.append("no-spam", queryParamOpts?.noSpam.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/tokens/${contractAddress}/nft_transactions/${tokenId}/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/tokens/${contractAddress}/nft_transactions/${tokenId}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftTransactionsResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftTransactionsResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -552,12 +634,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to fetch and render the traits of a collection as seen in rarity calculators.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -567,42 +651,47 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftCollectionTraitsResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftCollectionTraitsResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -610,12 +699,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to get the count of unique values for traits within an NFT collection.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -626,42 +717,47 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits/${trait}/attributes/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits/${trait}/attributes/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftCollectionAttributesForTraitResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftCollectionAttributesForTraitResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -669,12 +765,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to calculate rarity scores for a collection based on its traits.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -684,42 +782,47 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits_summary/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits_summary/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftCollectionTraitSummaryResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftCollectionTraitSummaryResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -727,12 +830,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -743,42 +848,47 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/collection/${collectionContract}/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/collection/${collectionContract}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftOwnershipForCollectionResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftOwnershipForCollectionResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -786,12 +896,14 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to verify ownership of a specific token (ERC-721 or ERC-1155) within a collection.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
@@ -803,42 +915,47 @@ class NftService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/collection/${collectionContract}/token/${tokenId}/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/collection/${collectionContract}/token/${tokenId}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftOwnershipForCollectionResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftOwnershipForCollectionResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -846,58 +963,221 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
     /**
+     *
+     * Commonly used to build a time-series chart of the sales count of an NFT collection.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {string} tokenId - The requested token ID.
+     * @param {GetNftMarketSaleCountQueryParamOpts} queryParamOpts
+     *   - `days`: The number of days to return data for. Request up 365 days. Defaults to 30 days.
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *
+     */
+    async getNftMarketSaleCount(chainName, contractAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.days !== undefined) {
+                    urlParams.append("days", queryParamOpts?.days.toString());
+                }
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft_market/${contractAddress}/sale_count/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": userAgent
+                    }
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new NftMarketSaleCountResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
+    /**
+     *
+     * Commonly used to build a time-series chart of the transaction volume of an NFT collection.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetNftMarketVolumeQueryParamOpts} queryParamOpts
+     *   - `days`: The number of days to return data for. Request up 365 days. Defaults to 30 days.
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *
+     */
+    async getNftMarketVolume(chainName, contractAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.days !== undefined) {
+                    urlParams.append("days", queryParamOpts?.days.toString());
+                }
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft_market/${contractAddress}/volume/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": userAgent
+                    }
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new NftMarketVolumeResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
+    /**
+     *
+     * Commonly used to render a price floor chart for an NFT collection.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetNftMarketFloorPriceQueryParamOpts} queryParamOpts
+     *   - `days`: The number of days to return data for. Request up 365 days. Defaults to 30 days.
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *
      */
-    async getNftExternalMetadataForContract(chainName, contractAddress, tokenId) {
+    async getNftMarketFloorPrice(chainName, contractAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/tokens/${contractAddress}/nft_metadata/${tokenId}/?${urlParams}`, {
+                if (queryParamOpts?.days !== undefined) {
+                    urlParams.append("days", queryParamOpts?.days.toString());
+                }
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft_market/${contractAddress}/floor_price/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new NftMetadataResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new NftMarketFloorPriceResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -905,11 +1185,10 @@ class NftService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
     }
 }
-exports.NftService = NftService;
 //# sourceMappingURL=NftService.js.map