@covalenthq/client-sdk 0.4.2 → 0.5.2

package/dist/es/index.js

@@ -277,7 +277,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"}`);
         }
     }
 }
@@ -327,6 +327,43 @@ class TokenSpenderItem {
         this.risk_factor = data.risk_factor;
     }
 }
+class NftApprovalsResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.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 ? 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
  *
@@ -389,7 +426,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) {
@@ -398,7 +499,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"
                 };
             }
         }
@@ -508,6 +609,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 ? 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 ? parseISO(data.block_signed_at.toString()) : null;
@@ -532,6 +644,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 ? parseISO(data.block_signed_at.toString()) : null;
@@ -606,6 +726,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 ? 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
  *
@@ -689,7 +834,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) {
@@ -698,7 +843,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"
                 };
             }
         }
@@ -763,7 +908,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) {
@@ -772,7 +917,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"
                 };
             }
         }
@@ -827,6 +972,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.
@@ -945,7 +1180,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) {
@@ -954,60 +1189,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 ? 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 ? parseISO(data.signed_at.toString()) : null;
-        this.height = data.height;
-    }
-}
-class ResolvedAddress {
-    constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
-        this.chain_id = data.chain_id;
-        this.chain_name = data.chain_name;
-        this.items = data.items && data.items !== null ? data.items.map((itemData) => new 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 ? 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 ? 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 ? 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 ? parseISO(data.signed_at.toString()) : null;
+        this.height = data.height;
+    }
+}
+class ResolvedAddress {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new 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 ? 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 ? 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;
@@ -1068,9 +1375,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 ? parseISO(data.updated_at.toString()) : null;
@@ -1166,7 +1484,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) {
@@ -1175,7 +1493,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"
                 };
             }
         }
@@ -1231,7 +1549,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) {
@@ -1240,7 +1558,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"
                 };
             }
         }
@@ -1355,7 +1673,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) {
@@ -1364,7 +1682,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"
                 };
             }
         }
@@ -1506,7 +1824,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) {
@@ -1515,7 +1833,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"
                 };
             }
         }
@@ -1569,7 +1887,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) {
@@ -1578,7 +1896,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"
                 };
             }
         }
@@ -1638,7 +1956,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) {
@@ -1647,7 +1965,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"
                 };
             }
         }
@@ -1903,6 +2221,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 ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketSaleCountItem(itemData)) : null;
+    }
+}
+class MarketSaleCountItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.sale_count = data.sale_count;
+    }
+}
+class NftMarketVolumeResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketVolumeItem(itemData)) : null;
+    }
+}
+class MarketVolumeItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.native_ticker_symbol = data.native_ticker_symbol;
+        this.native_name = data.native_name;
+        this.volume_quote = data.volume_quote;
+        this.volume_native_quote = data.volume_native_quote;
+        this.pretty_volume_quote = data.pretty_volume_quote;
+    }
+}
+class NftMarketFloorPriceResponse {
+    constructor(data) {
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.address = data.address;
+        this.quote_currency = data.quote_currency;
+        this.chain_name = data.chain_name;
+        this.chain_id = data.chain_id;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new MarketFloorPriceItem(itemData)) : null;
+    }
+}
+class MarketFloorPriceItem {
+    constructor(data) {
+        this.date = data.date && data.date !== null ? parseISO(data.date.toString()) : null;
+        this.native_ticker_symbol = data.native_ticker_symbol;
+        this.native_name = data.native_name;
+        this.floor_price_native_quote = data.floor_price_native_quote;
+        this.floor_price_quote = data.floor_price_quote;
+        this.pretty_floor_price_quote = data.pretty_floor_price_quote;
+    }
+}
 /**
  * NFT APIs
  *
@@ -1971,20 +2345,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
@@ -2008,14 +2643,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) {
@@ -2024,74 +2659,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;
@@ -2099,17 +2681,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
@@ -2133,14 +2709,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) {
@@ -2149,23 +2725,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;
@@ -2173,14 +2746,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
@@ -2204,14 +2774,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) {
@@ -2220,20 +2790,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;
@@ -2245,7 +2816,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
@@ -2269,14 +2840,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) {
@@ -2285,21 +2856,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;
@@ -2311,7 +2883,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
@@ -2335,14 +2907,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) {
@@ -2351,20 +2923,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;
@@ -2372,11 +2947,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
@@ -2400,14 +2981,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) {
@@ -2416,21 +2997,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;
@@ -2438,11 +3021,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
@@ -2466,14 +3055,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) {
@@ -2482,22 +3071,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;
@@ -2505,11 +3095,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
@@ -2533,14 +3129,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) {
@@ -2549,7 +3145,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"
                 };
             }
         }
@@ -2664,7 +3260,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) {
@@ -2673,7 +3269,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"
                 };
             }
         }
@@ -2716,6 +3312,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 {
@@ -2862,6 +3459,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;
@@ -2878,6 +3482,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 ? parseISO(data.updated_at.toString()) : null;
@@ -2909,6 +3519,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 ? 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
  *
@@ -2965,7 +3587,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"}`);
         }
     }
 }
@@ -2988,6 +3610,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) {
@@ -3013,6 +3636,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();
@@ -3048,7 +3674,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) {
@@ -3057,7 +3683,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"
                 };
             }
         }
@@ -3072,6 +3698,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) {
@@ -3089,6 +3716,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;
                 }
@@ -3160,7 +3790,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) {
@@ -3169,7 +3799,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"
                 };
             }
         }
@@ -3225,7 +3855,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) {
@@ -3234,7 +3945,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"
                 };
             }
         }
@@ -3696,7 +4407,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) {
@@ -3705,7 +4416,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"
                 };
             }
         }
@@ -3761,7 +4472,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) {
@@ -3770,7 +4481,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"
                 };
             }
         }
@@ -3827,7 +4538,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) {
@@ -3836,7 +4547,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"
                 };
             }
         }
@@ -3863,6 +4574,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();
@@ -3898,7 +4612,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) {
@@ -3907,7 +4621,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"
                 };
             }
         }
@@ -3964,7 +4678,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) {
@@ -3973,7 +4687,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"
                 };
             }
         }
@@ -4004,6 +4718,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();
@@ -4039,7 +4756,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) {
@@ -4048,7 +4765,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"
                 };
             }
         }
@@ -4104,7 +4821,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) {
@@ -4113,7 +4830,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"
                 };
             }
         }
@@ -4167,7 +4884,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) {
@@ -4176,7 +4893,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"
                 };
             }
         }
@@ -4233,7 +4950,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) {
@@ -4242,7 +4959,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"
                 };
             }
         }
@@ -4299,7 +5016,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) {
@@ -4308,7 +5025,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"
                 };
             }
         }
@@ -4365,7 +5082,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) {
@@ -4374,7 +5091,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"
                 };
             }
         }
@@ -4431,7 +5148,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) {
@@ -4440,7 +5157,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"
                 };
             }
         }
@@ -4496,7 +5213,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) {
@@ -4505,7 +5222,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"
                 };
             }
         }
@@ -4561,7 +5278,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) {
@@ -4570,14 +5287,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
  */