@covalenthq/client-sdk 0.4.2 → 0.5.2

package/dist/cjs/index.js

@@ -279,7 +279,7 @@ async function* paginateEndpoint$1(url, apiKey, urlsParams, dataClassConstructor
             if (error.message.includes("An error occurred 429")) {
                 throw new Error(error.message);
             }
-            throw new Error(`An error occurred ${data ? data.error_code : response.status}: ${data ? data.error_message : "401 Authorization Required"}`);
+            throw new Error(`An error occurred ${data ? data.error_code : response.status}: ${data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"}`);
         }
     }
 }
@@ -329,6 +329,43 @@ class TokenSpenderItem {
         this.risk_factor = data.risk_factor;
     }
 }
+class NftApprovalsResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.address = data.address;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new NftApprovalsItem(itemData)) : null;
+    }
+}
+class NftApprovalsItem {
+    constructor(data) {
+        this.contract_address = data.contract_address;
+        this.contract_address_label = data.contract_address_label;
+        this.contract_ticker_symbol = data.contract_ticker_symbol;
+        this.token_balances = data.token_balances && data.token_balances !== null ? data.token_balances.map((itemData) => new NftApprovalBalance(itemData)) : null;
+        this.spenders = data.spenders && data.spenders !== null ? data.spenders.map((itemData) => new NftApprovalSpender(itemData)) : null;
+    }
+}
+class NftApprovalBalance {
+    constructor(data) {
+        this.token_id = data.token_id && data.token_id !== null ? BigInt(data.token_id) : null;
+        this.token_balance = data.token_balance && data.token_balance !== null ? BigInt(data.token_balance) : null;
+    }
+}
+class NftApprovalSpender {
+    constructor(data) {
+        this.block_height = data.block_height;
+        this.tx_offset = data.tx_offset;
+        this.log_offset = data.log_offset;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? dateFns.parseISO(data.block_signed_at.toString()) : null;
+        this.tx_hash = data.tx_hash;
+        this.spender_address = data.spender_address;
+        this.spender_address_label = data.spender_address_label;
+        this.token_ids_approved = data.token_ids_approved;
+        this.allowance = data.allowance;
+    }
+}
 /**
  * Approvals API
  *
@@ -391,7 +428,71 @@ class SecurityService {
                     data: dataClass,
                     error: data.error,
                     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"
+                };
+            }
+            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"
+                };
+            }
+        }
+    }
+    /**
+     *
+     * @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.
+     
+     *
+     */
+    async getNftApprovals(chainName, walletAddress) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                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/approvals/${walletAddress}/?${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 NftApprovalsResponse(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) {
@@ -400,7 +501,7 @@ class SecurityService {
                     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"
                 };
             }
         }
@@ -510,6 +611,17 @@ class OhlcItem {
         this.pretty_quote = data.pretty_quote;
     }
 }
+class Erc20TransfersResponse {
+    constructor(data) {
+        this.address = data.address;
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
+        this.quote_currency = data.quote_currency;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new BlockTransactionWithContractTransfers(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$2(data.pagination) : null;
+    }
+}
 class BlockTransactionWithContractTransfers {
     constructor(data) {
         this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? dateFns.parseISO(data.block_signed_at.toString()) : null;
@@ -534,6 +646,14 @@ class BlockTransactionWithContractTransfers {
         this.transfers = data.transfers && data.transfers !== null ? data.transfers.map((itemData) => new TokenTransferItem(itemData)) : null;
     }
 }
+let Pagination$2 = class Pagination {
+    constructor(data) {
+        this.has_more = data.has_more;
+        this.page_number = data.page_number;
+        this.page_size = data.page_size;
+        this.total_count = data.total_count;
+    }
+};
 class TokenTransferItem {
     constructor(data) {
         this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? dateFns.parseISO(data.block_signed_at.toString()) : null;
@@ -608,6 +728,31 @@ class HistoricalBalanceItem {
         this.nft_data = data.nft_data && data.nft_data !== null ? data.nft_data.map((itemData) => new NftData$1(itemData)) : null;
     }
 }
+class TokenBalanceNativeResponse {
+    constructor(data) {
+        this.address = data.address;
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
+        this.quote_currency = data.quote_currency;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new NativeBalanceItem(itemData)) : null;
+    }
+}
+class NativeBalanceItem {
+    constructor(data) {
+        this.contract_decimals = data.contract_decimals;
+        this.contract_name = data.contract_name;
+        this.contract_ticker_symbol = data.contract_ticker_symbol;
+        this.contract_address = data.contract_address;
+        this.supports_erc = data.supports_erc;
+        this.logo_url = data.logo_url;
+        this.block_height = data.block_height;
+        this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
+        this.quote_rate = data.quote_rate;
+        this.quote = data.quote;
+        this.pretty_quote = data.pretty_quote;
+    }
+}
 /**
  * Balances APIs
  *
@@ -691,7 +836,7 @@ class BalanceService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -700,7 +845,7 @@ class BalanceService {
                     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"
                 };
             }
         }
@@ -765,7 +910,7 @@ class BalanceService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -774,7 +919,7 @@ class BalanceService {
                     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"
                 };
             }
         }
@@ -829,6 +974,96 @@ class BalanceService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from 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.
+     * @param {GetErc20TransfersForWalletAddressQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `contractAddress`: The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     *   - `startingBlock`: The block height to start from, defaults to `0`.
+     *   - `endingBlock`: The block height to end at, defaults to current block height.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async getErc20TransfersForWalletAddressByPage(chainName, walletAddress, 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?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.contractAddress !== undefined) {
+                    urlParams.append("contract-address", queryParamOpts?.contractAddress.toString());
+                }
+                if (queryParamOpts?.startingBlock !== undefined) {
+                    urlParams.append("starting-block", queryParamOpts?.startingBlock.toString());
+                }
+                if (queryParamOpts?.endingBlock !== undefined) {
+                    urlParams.append("ending-block", queryParamOpts?.endingBlock.toString());
+                }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.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}/address/${walletAddress}/transfers_v2/?${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 Erc20TransfersResponse(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 get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.
@@ -947,7 +1182,7 @@ class BalanceService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -956,60 +1191,132 @@ class BalanceService {
                     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"
                 };
             }
         }
     }
-}
-
-class BlockResponse {
-    constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 Block(itemData)) : null;
-    }
-}
-class Block {
-    constructor(data) {
-        this.signed_at = data.signed_at && data.signed_at !== null ? dateFns.parseISO(data.signed_at.toString()) : null;
-        this.height = data.height;
-    }
-}
-class ResolvedAddress {
-    constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 ResolvedAddressItem(itemData)) : null;
-    }
-}
-class ResolvedAddressItem {
-    constructor(data) {
-        this.address = data.address;
-        this.name = data.name;
-    }
-}
-class GetLogsResponse {
-    constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 GetLogsEvent(itemData)) : null;
-    }
-}
-class GetLogsEvent {
-    constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? dateFns.parseISO(data.block_signed_at.toString()) : null;
-        this.block_height = data.block_height;
-        this.block_hash = data.block_hash;
-        this.tx_offset = data.tx_offset;
-        this.log_offset = data.log_offset;
-        this.tx_hash = data.tx_hash;
-        this.raw_log_topics = data.raw_log_topics;
-        this.sender_contract_decimals = data.sender_contract_decimals;
-        this.sender_name = data.sender_name;
+    /**
+     *
+     * @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.
+     * @param {GetNativeTokenBalanceQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     *
+     */
+    async getNativeTokenBalance(chainName, walletAddress, 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?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.blockHeight !== undefined) {
+                    urlParams.append("block-height", queryParamOpts?.blockHeight.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}/address/${walletAddress}/balances_native/?${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 TokenBalanceNativeResponse(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"
+                };
+            }
+        }
+    }
+}
+
+class BlockResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 Block(itemData)) : null;
+    }
+}
+class Block {
+    constructor(data) {
+        this.signed_at = data.signed_at && data.signed_at !== null ? dateFns.parseISO(data.signed_at.toString()) : null;
+        this.height = data.height;
+    }
+}
+class ResolvedAddress {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 ResolvedAddressItem(itemData)) : null;
+    }
+}
+class ResolvedAddressItem {
+    constructor(data) {
+        this.address = data.address;
+        this.name = data.name;
+    }
+}
+class GetLogsResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.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 GetLogsEvent(itemData)) : null;
+    }
+}
+class GetLogsEvent {
+    constructor(data) {
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? dateFns.parseISO(data.block_signed_at.toString()) : null;
+        this.block_height = data.block_height;
+        this.block_hash = data.block_hash;
+        this.tx_offset = data.tx_offset;
+        this.log_offset = data.log_offset;
+        this.tx_hash = data.tx_hash;
+        this.raw_log_topics = data.raw_log_topics;
+        this.sender_contract_decimals = data.sender_contract_decimals;
+        this.sender_name = data.sender_name;
         this.sender_contract_ticker_symbol = data.sender_contract_ticker_symbol;
         this.sender_address = data.sender_address;
         this.sender_address_label = data.sender_address_label;
@@ -1070,9 +1377,20 @@ class ChainItem {
         this.black_logo_url = data.black_logo_url;
         this.white_logo_url = data.white_logo_url;
         this.is_appchain = data.is_appchain;
+        this.color_theme = data.color_theme && data.color_theme !== null ? new ColorTheme(data.color_theme) : null;
         this.appchain_of = data.appchain_of && data.appchain_of !== null ? new ChainItem(data.appchain_of) : null;
     }
 }
+class ColorTheme {
+    constructor(data) {
+        this.red = data.red;
+        this.green = data.green;
+        this.blue = data.blue;
+        this.alpha = data.alpha;
+        this.hex = data.hex;
+        this.css_rgb = data.css_rgb;
+    }
+}
 class AllChainsStatusResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
@@ -1168,7 +1486,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1177,7 +1495,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1233,7 +1551,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1242,7 +1560,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1357,7 +1675,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1366,7 +1684,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1508,7 +1826,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1517,7 +1835,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1571,7 +1889,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1580,7 +1898,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1640,7 +1958,7 @@ class BaseService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -1649,7 +1967,7 @@ class BaseService {
                     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"
                 };
             }
         }
@@ -1905,6 +2223,62 @@ class NftOwnershipForCollectionItem {
         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 ? dateFns.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 ? dateFns.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 ? dateFns.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 ? dateFns.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 ? dateFns.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 ? dateFns.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
  *
@@ -1973,20 +2347,281 @@ class NftService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                if (queryParamOpts?.noSpam !== undefined) {
-                    urlParams.append("no-spam", queryParamOpts?.noSpam.toString());
-                }
-                if (queryParamOpts?.noNftAssetMetadata !== undefined) {
-                    urlParams.append("no-nft-asset-metadata", queryParamOpts?.noNftAssetMetadata.toString());
-                }
-                if (queryParamOpts?.withUncached !== undefined) {
-                    urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
-                }
+                if (queryParamOpts?.noSpam !== undefined) {
+                    urlParams.append("no-spam", queryParamOpts?.noSpam.toString());
+                }
+                if (queryParamOpts?.noNftAssetMetadata !== undefined) {
+                    urlParams.append("no-nft-asset-metadata", queryParamOpts?.noNftAssetMetadata.toString());
+                }
+                if (queryParamOpts?.withUncached !== undefined) {
+                    urlParams.append("with-uncached", queryParamOpts?.withUncached.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}/address/${walletAddress}/balances_nft/?${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 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;
+                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 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.
+     * @param {GetTokenIdsForContractWithMetadataQueryParamOpts} queryParamOpts
+     *   - `noMetadata`: Omit metadata.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *   - `traitsFilter`: Filters NFTs based on a specific trait. If this filter is used, the API will return all NFTs with the specified trait. Accepts comma-separated values, is case-sensitive, and requires proper URL encoding.
+     *   - `valuesFilter`: Filters NFTs based on a specific trait value. If this filter is used, the API will return all NFTs with the specified trait value. If used with "traits-filter", only NFTs matching both filters will be returned. Accepts comma-separated values, is case-sensitive, and requires proper URL encoding.
+     *   - `withUncached`: By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to `true`, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.
+     *
+     */
+    async *getTokenIdsForContractWithMetadata(chainName, contractAddress, queryParamOpts) {
+        let success = false;
+        let res;
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.noMetadata !== undefined) {
+                    urlParams.append("no-metadata", queryParamOpts?.noMetadata.toString());
+                }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
+                if (queryParamOpts?.traitsFilter !== undefined) {
+                    urlParams.append("traits-filter", queryParamOpts?.traitsFilter.toString());
+                }
+                if (queryParamOpts?.valuesFilter !== undefined) {
+                    urlParams.append("values-filter", queryParamOpts?.valuesFilter.toString());
+                }
+                if (queryParamOpts?.withUncached !== undefined) {
+                    urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
+                }
+                for await (res of paginateEndpoint$1(`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;
+                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.
+     * @param {string} tokenId - The requested token ID.
+     * @param {GetNftMetadataForGivenTokenIdForContractQueryParamOpts} queryParamOpts
+     *   - `noMetadata`: Omit metadata.
+     *   - `withUncached`: By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to `true`, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.
+     *
+     */
+    async getNftMetadataForGivenTokenIdForContract(chainName, contractAddress, tokenId, 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?.noMetadata !== undefined) {
+                    urlParams.append("no-metadata", queryParamOpts?.noMetadata.toString());
+                }
+                if (queryParamOpts?.withUncached !== undefined) {
+                    urlParams.append("with-uncached", queryParamOpts?.withUncached.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/${contractAddress}/metadata/${tokenId}/?${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 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;
+                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 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.
+     * @param {string} tokenId - The requested token ID.
+     * @param {GetNftTransactionsForContractTokenIdQueryParamOpts} queryParamOpts
+     *   - `noSpam`: If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`.
+     *
+     */
+    async getNftTransactionsForContractTokenId(chainName, contractAddress, tokenId, 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?.noSpam !== undefined) {
+                    urlParams.append("no-spam", queryParamOpts?.noSpam.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}/tokens/${contractAddress}/nft_transactions/${tokenId}/?${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 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;
+                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 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.
+     *
+     */
+    async getTraitsForCollection(chainName, collectionContract) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
                 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}`, {
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
                         "X-Requested-With": userAgent
@@ -2010,14 +2645,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftAddressBalanceNftResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2026,74 +2661,21 @@ 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.
-     * @param {GetTokenIdsForContractWithMetadataQueryParamOpts} queryParamOpts
-     *   - `noMetadata`: Omit metadata.
-     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
-     *   - `pageNumber`: 0-indexed page number to begin pagination.
-     *   - `traitsFilter`: Filters NFTs based on a specific trait. If this filter is used, the API will return all NFTs with the specified trait. Accepts comma-separated values, is case-sensitive, and requires proper URL encoding.
-     *   - `valuesFilter`: Filters NFTs based on a specific trait value. If this filter is used, the API will return all NFTs with the specified trait value. If used with "traits-filter", only NFTs matching both filters will be returned. Accepts comma-separated values, is case-sensitive, and requires proper URL encoding.
-     *   - `withUncached`: By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to `true`, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.
-     *
-     */
-    async *getTokenIdsForContractWithMetadata(chainName, contractAddress, queryParamOpts) {
-        let success = false;
-        let res;
-        while (!success) {
-            try {
-                const urlParams = new URLSearchParams();
-                if (queryParamOpts?.noMetadata !== undefined) {
-                    urlParams.append("no-metadata", queryParamOpts?.noMetadata.toString());
-                }
-                if (queryParamOpts?.pageSize !== undefined) {
-                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
-                }
-                if (queryParamOpts?.pageNumber !== undefined) {
-                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
-                }
-                if (queryParamOpts?.traitsFilter !== undefined) {
-                    urlParams.append("traits-filter", queryParamOpts?.traitsFilter.toString());
-                }
-                if (queryParamOpts?.valuesFilter !== undefined) {
-                    urlParams.append("values-filter", queryParamOpts?.valuesFilter.toString());
-                }
-                if (queryParamOpts?.withUncached !== undefined) {
-                    urlParams.append("with-uncached", queryParamOpts?.withUncached.toString());
-                }
-                for await (res of paginateEndpoint$1(`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;
-                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.
+     * 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} 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 {GetNftMetadataForGivenTokenIdForContractQueryParamOpts} queryParamOpts
-     *   - `noMetadata`: Omit metadata.
-     *   - `withUncached`: By default, this endpoint only works on chains where we've cached the assets and the metadata. When set to `true`, the API will fetch metadata from upstream servers even if it's not cached - the downside being that the upstream server can block or rate limit the call and therefore resulting in time outs or slow response times on the Covalent side.
+     * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} trait - The requested trait.
      *
      */
-    async getNftMetadataForGivenTokenIdForContract(chainName, contractAddress, tokenId, queryParamOpts) {
+    async getAttributesForTraitInCollection(chainName, collectionContract, trait) {
         let success = false;
         let data;
         let response;
@@ -2101,17 +2683,11 @@ class NftService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                if (queryParamOpts?.noMetadata !== undefined) {
-                    urlParams.append("no-metadata", queryParamOpts?.noMetadata.toString());
-                }
-                if (queryParamOpts?.withUncached !== undefined) {
-                    urlParams.append("with-uncached", queryParamOpts?.withUncached.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/${contractAddress}/metadata/${tokenId}/?${urlParams}`, {
+                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": userAgent
@@ -2135,14 +2711,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftMetadataResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2151,23 +2727,20 @@ 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.
+     * Commonly used to calculate rarity scores for a collection based on its traits.
      *
      * @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 {GetNftTransactionsForContractTokenIdQueryParamOpts} queryParamOpts
-     *   - `noSpam`: If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`.
+     * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
      *
      */
-    async getNftTransactionsForContractTokenId(chainName, contractAddress, tokenId, queryParamOpts) {
+    async getCollectionTraitsSummary(chainName, collectionContract) {
         let success = false;
         let data;
         let response;
@@ -2175,14 +2748,11 @@ class NftService {
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                if (queryParamOpts?.noSpam !== undefined) {
-                    urlParams.append("no-spam", queryParamOpts?.noSpam.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}/tokens/${contractAddress}/nft_transactions/${tokenId}/?${urlParams}`, {
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/nft/${collectionContract}/traits_summary/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
                         "X-Requested-With": userAgent
@@ -2206,14 +2776,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftTransactionsResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2222,20 +2792,21 @@ 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.
+     * 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} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} collectionContract - The requested collection address.
      *
      */
-    async getTraitsForCollection(chainName, collectionContract) {
+    async checkOwnershipInNft(chainName, walletAddress, collectionContract) {
         let success = false;
         let data;
         let response;
@@ -2247,7 +2818,7 @@ class NftService {
                 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}`, {
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/collection/${collectionContract}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
                         "X-Requested-With": userAgent
@@ -2271,14 +2842,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftCollectionTraitsResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2287,21 +2858,22 @@ 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.
+     * 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.
      * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {string} trait - The requested trait.
+     * @param {string} tokenId - The requested token ID.
      *
      */
-    async getAttributesForTraitInCollection(chainName, collectionContract, trait) {
+    async checkOwnershipInNftForSpecificTokenId(chainName, walletAddress, collectionContract, tokenId) {
         let success = false;
         let data;
         let response;
@@ -2313,7 +2885,7 @@ class NftService {
                 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}`, {
+                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": userAgent
@@ -2337,14 +2909,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftCollectionAttributesForTraitResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2353,20 +2925,23 @@ 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.
+     * 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} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} contractAddress - The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @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 getCollectionTraitsSummary(chainName, collectionContract) {
+    async getNftMarketSaleCount(chainName, contractAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -2374,11 +2949,17 @@ class NftService {
         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/${collectionContract}/traits_summary/?${urlParams}`, {
+                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
@@ -2402,14 +2983,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftCollectionTraitSummaryResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2418,21 +2999,23 @@ 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.
+     * 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} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {string} collectionContract - The requested collection address.
+     * @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 checkOwnershipInNft(chainName, walletAddress, collectionContract) {
+    async getNftMarketVolume(chainName, contractAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -2440,11 +3023,17 @@ class NftService {
         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}/address/${walletAddress}/collection/${collectionContract}/?${urlParams}`, {
+                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
@@ -2468,14 +3057,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftOwnershipForCollectionResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2484,22 +3073,23 @@ 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.
+     * Commonly used to render a price floor chart for an NFT 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.
-     * @param {string} collectionContract - The requested collection address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {string} tokenId - The requested token ID.
+     * @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 checkOwnershipInNftForSpecificTokenId(chainName, walletAddress, collectionContract, tokenId) {
+    async getNftMarketFloorPrice(chainName, contractAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -2507,11 +3097,17 @@ class NftService {
         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}/address/${walletAddress}/collection/${collectionContract}/token/${tokenId}/?${urlParams}`, {
+                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": userAgent
@@ -2535,14 +3131,14 @@ class NftService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new NftOwnershipForCollectionResponse(data.data);
+                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 : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -2551,7 +3147,7 @@ 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"
                 };
             }
         }
@@ -2666,7 +3262,7 @@ class PricingService {
                     data: res,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -2675,7 +3271,7 @@ class PricingService {
                     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"
                 };
             }
         }
@@ -2718,6 +3314,7 @@ class Transaction {
         this.nft_sale_details = data.nft_sale_details && data.nft_sale_details !== null ? new NftSalesReport(data.nft_sale_details) : null;
         this.lending_details = data.lending_details && data.lending_details !== null ? new LendingReport(data.lending_details) : null;
         this.log_events = data.log_events && data.log_events !== null ? data.log_events.map((itemData) => new LogEvent(itemData)) : null;
+        this.safe_details = data.safe_details && data.safe_details !== null ? data.safe_details.map((itemData) => new SafeDetails(itemData)) : null;
     }
 }
 class ContractMetadata {
@@ -2864,6 +3461,13 @@ class LogEvent {
         this.decoded = data.decoded && data.decoded !== null ? new DecodedItem(data.decoded) : null;
     }
 }
+class SafeDetails {
+    constructor(data) {
+        this.owner_address = data.owner_address;
+        this.signature = data.signature;
+        this.signature_type = data.signature_type;
+    }
+}
 class DecodedItem {
     constructor(data) {
         this.name = data.name;
@@ -2880,6 +3484,12 @@ class Param {
         this.value = data.value;
     }
 }
+class PaginationLinks {
+    constructor(data) {
+        this.prev = data.prev;
+        this.next = data.next;
+    }
+}
 class TransactionsBlockResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
@@ -2911,6 +3521,18 @@ class TransactionSummary {
         this.tx_detail_link = data.tx_detail_link;
     }
 }
+class TransactionsResponse {
+    constructor(data) {
+        this.address = data.address;
+        this.updated_at = data.updated_at && data.updated_at !== null ? dateFns.parseISO(data.updated_at.toString()) : null;
+        this.quote_currency = data.quote_currency;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.current_page = data.current_page;
+        this.links = data.links && data.links !== null ? new PaginationLinks(data.links) : null;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new Transaction(itemData)) : null;
+    }
+}
 /**
  * Transactions APIs
  *
@@ -2967,7 +3589,7 @@ async function* paginateEndpoint(url, apiKey, urlsParams, debug, threadCount) {
             if (error.message.includes("An error occurred 429")) {
                 throw new Error(error.message);
             }
-            throw new Error(`An error occurred ${data ? data.error_code : response.status}: ${data ? data.error_message : "401 Authorization Required"}`);
+            throw new Error(`An error occurred ${data ? data.error_code : response.status}: ${data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"}`);
         }
     }
 }
@@ -2990,6 +3612,7 @@ class TransactionService {
      *   - `withDex`: Decoded DEX details including protocol (e.g. Uniswap), event (e.g 'add_liquidity') and tokens involved with historical prices. Additional 0.05 credits charged if data available.
      *   - `withNftSales`: Decoded NFT sales details including marketplace (e.g. Opensea) and cached media links. Additional 0.05 credits charged if data available.
      *   - `withLending`: Decoded lending details including protocol (e.g. Aave), event (e.g. 'deposit') and tokens involved with prices. Additional 0.05 credits charged if data available.
+     *   - `withSafe`: Include safe details.
      *
      */
     async getTransaction(chainName, txHash, queryParamOpts) {
@@ -3015,6 +3638,9 @@ class TransactionService {
                 if (queryParamOpts?.withLending !== undefined) {
                     urlParams.append("with-lending", queryParamOpts?.withLending.toString());
                 }
+                if (queryParamOpts?.withSafe !== undefined) {
+                    urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
+                }
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -3050,7 +3676,7 @@ class TransactionService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3059,7 +3685,7 @@ class TransactionService {
                     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"
                 };
             }
         }
@@ -3074,6 +3700,7 @@ class TransactionService {
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
      *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
+     *   - `withSafe`: Include safe details.
      *
      */
     async *getAllTransactionsForAddress(chainName, walletAddress, queryParamOpts) {
@@ -3091,6 +3718,9 @@ class TransactionService {
                 if (queryParamOpts?.blockSignedAtAsc !== undefined) {
                     urlParams.append("block-signed-at-asc", queryParamOpts?.blockSignedAtAsc.toString());
                 }
+                if (queryParamOpts?.withSafe !== undefined) {
+                    urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
+                }
                 for await (tx of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/`, this.apiKey, urlParams, this.debug, this.threadCount)) {
                     yield tx;
                 }
@@ -3162,7 +3792,7 @@ class TransactionService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3171,7 +3801,7 @@ class TransactionService {
                     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"
                 };
             }
         }
@@ -3227,7 +3857,88 @@ class TransactionService {
                     data: dataClass,
                     error: data.error,
                     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"
+                };
+            }
+            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"
+                };
+            }
+        }
+    }
+    /**
+     *
+     * @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.
+     * @param {number} page - The requested page, 0-indexed.
+     * @param {GetTransactionsForAddressV3QueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `noLogs`: Omit log events.
+     *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
+     *   - `withSafe`: Include safe details.
+     *
+     */
+    async getTransactionsForAddressV3(chainName, walletAddress, page, 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?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.noLogs !== undefined) {
+                    urlParams.append("no-logs", queryParamOpts?.noLogs.toString());
+                }
+                if (queryParamOpts?.blockSignedAtAsc !== undefined) {
+                    urlParams.append("block-signed-at-asc", queryParamOpts?.blockSignedAtAsc.toString());
+                }
+                if (queryParamOpts?.withSafe !== undefined) {
+                    urlParams.append("with-safe", queryParamOpts?.withSafe.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transactions_v3/page/${page}/?${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 TransactionsResponse(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) {
@@ -3236,7 +3947,7 @@ class TransactionService {
                     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"
                 };
             }
         }
@@ -3698,7 +4409,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3707,7 +4418,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -3763,7 +4474,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3772,7 +4483,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -3829,7 +4540,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3838,7 +4549,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -3865,6 +4576,9 @@ class XykService {
                 if (queryParamOpts?.quoteCurrency !== undefined) {
                     urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
                 }
+                if (queryParamOpts?.dexName !== undefined) {
+                    urlParams.append("dex-name", queryParamOpts?.dexName.toString());
+                }
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -3900,7 +4614,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3909,7 +4623,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -3966,7 +4680,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -3975,7 +4689,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4006,6 +4720,9 @@ class XykService {
                 if (queryParamOpts?.quoteCurrency !== undefined) {
                     urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
                 }
+                if (queryParamOpts?.dexName !== undefined) {
+                    urlParams.append("dex-name", queryParamOpts?.dexName.toString());
+                }
                 let startTime;
                 if (this.debug) {
                     startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
@@ -4041,7 +4758,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4050,7 +4767,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4106,7 +4823,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4115,7 +4832,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4169,7 +4886,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4178,7 +4895,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4235,7 +4952,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4244,7 +4961,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4301,7 +5018,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4310,7 +5027,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4367,7 +5084,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4376,7 +5093,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4433,7 +5150,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4442,7 +5159,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4498,7 +5215,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4507,7 +5224,7 @@ class XykService {
                     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"
                 };
             }
         }
@@ -4563,7 +5280,7 @@ class XykService {
                     data: dataClass,
                     error: data.error,
                     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"
                 };
             }
             catch (error) {
@@ -4572,14 +5289,14 @@ class XykService {
                     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"
                 };
             }
         }
     }
 }
 
-const userAgent = "com.covalenthq.sdk.typescript/0.4.2";
+const userAgent = "com.covalenthq.sdk.typescript/0.5.2";
 /**
  * CovalentClient Class
  */