@covalenthq/client-sdk 0.5.2 → 0.6.0

package/dist/esm/index.js

@@ -617,7 +617,7 @@ class Erc20TransfersResponse {
         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;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$3(data.pagination) : null;
     }
 }
 class BlockTransactionWithContractTransfers {
@@ -644,7 +644,7 @@ class BlockTransactionWithContractTransfers {
         this.transfers = data.transfers && data.transfers !== null ? data.transfers.map((itemData) => new TokenTransferItem(itemData)) : null;
     }
 }
-let Pagination$2 = class Pagination {
+let Pagination$3 = class Pagination {
     constructor(data) {
         this.has_more = data.has_more;
         this.page_number = data.page_number;
@@ -681,6 +681,15 @@ class MethodCallsForTransfers {
         this.method = data.method;
     }
 }
+class TokenHoldersResponse {
+    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 TokenHolder(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$3(data.pagination) : null;
+    }
+}
 class TokenHolder {
     constructor(data) {
         this.contract_decimals = data.contract_decimals;
@@ -1072,6 +1081,7 @@ class BalanceService {
      *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
      *   - `pageSize`: Number of items per page. Note: Currently, only values of `100` and `1000` are supported. Omitting this parameter defaults to 100.
      *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
      *
      */
     async *getTokenHoldersV2ForTokenAddress(chainName, tokenAddress, queryParamOpts) {
@@ -1089,6 +1099,9 @@ class BalanceService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
+                if (queryParamOpts?.date !== undefined) {
+                    urlParams.append("date", queryParamOpts?.date.toString());
+                }
                 for await (res of paginateEndpoint$1(`https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/`, this.apiKey, urlParams, TokenHolder, this.debug, this.threadCount)) {
                     yield res;
                 }
@@ -1100,6 +1113,88 @@ class BalanceService {
             }
         }
     }
+    /**
+     *
+     * 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.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} tokenAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetTokenHoldersV2ForTokenAddressQueryParamOpts} queryParamOpts
+     *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     *   - `pageSize`: Number of items per page. Note: Currently, only values of `100` and `1000` are supported. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
+     *
+     */
+    async getTokenHoldersV2ForTokenAddressByPage(chainName, tokenAddress, 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?.blockHeight !== undefined) {
+                    urlParams.append("block-height", queryParamOpts?.blockHeight.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?.date !== undefined) {
+                    urlParams.append("date", queryParamOpts?.date.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/${tokenAddress}/token_holders_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 TokenHoldersResponse(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 the historical native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address at a given block height or date. Response includes daily prices and other metadata.
@@ -1296,6 +1391,23 @@ class ResolvedAddressItem {
         this.name = data.name;
     }
 }
+class BlockHeightsResponse {
+    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;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$2(data.pagination) : 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 GetLogsResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
@@ -1339,6 +1451,15 @@ let Param$2 = class Param {
         this.value = data.value;
     }
 };
+class LogEventsByAddressResponse {
+    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 LogEvent$2(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$2(data.pagination) : null;
+    }
+}
 let LogEvent$2 = class LogEvent {
     constructor(data) {
         this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
@@ -1357,6 +1478,15 @@ let LogEvent$2 = class LogEvent {
         this.decoded = data.decoded && data.decoded !== null ? new DecodedItem$2(data.decoded) : null;
     }
 };
+class LogEventsByTopicHashResponse {
+    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 LogEvent$2(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$2(data.pagination) : null;
+    }
+}
 class AllChainsResponse {
     constructor(data) {
         this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
@@ -1598,6 +1728,81 @@ class BaseService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} startDate - The start date in YYYY-MM-DD format.
+     * @param {string} endDate - The end date in YYYY-MM-DD format.
+     * @param {GetBlockHeightsQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async getBlockHeightsByPage(chainName, startDate, endDate, 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?.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}/block_v2/${startDate}/${endDate}/?${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 BlockHeightsResponse(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 the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.
@@ -1612,7 +1817,137 @@ class BaseService {
      *   - `skipDecode`: Omit decoded log events.
      *
      */
-    async getLogs(chainName, queryParamOpts) {
+    async getLogs(chainName, 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?.startingBlock !== undefined) {
+                    urlParams.append("starting-block", queryParamOpts?.startingBlock.toString());
+                }
+                if (queryParamOpts?.endingBlock !== undefined) {
+                    urlParams.append("ending-block", queryParamOpts?.endingBlock.toString());
+                }
+                if (queryParamOpts?.address !== undefined) {
+                    urlParams.append("address", queryParamOpts?.address.toString());
+                }
+                if (queryParamOpts?.topics !== undefined) {
+                    urlParams.append("topics", queryParamOpts?.topics.toString());
+                }
+                if (queryParamOpts?.blockHash !== undefined) {
+                    urlParams.append("block-hash", queryParamOpts?.blockHash.toString());
+                }
+                if (queryParamOpts?.skipDecode !== undefined) {
+                    urlParams.append("skip-decode", queryParamOpts?.skipDecode.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}/events/?${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 GetLogsResponse(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 the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.
+     *
+     * @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 {GetLogEventsByAddressQueryParamOpts} queryParamOpts
+     *   - `startingBlock`: The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
+     *   - `endingBlock`: The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async *getLogEventsByAddress(chainName, contractAddress, queryParamOpts) {
+        let success = false;
+        let res;
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                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());
+                }
+                for await (res of paginateEndpoint$1(`https://api.covalenthq.com/v1/${chainName}/events/address/${contractAddress}/`, this.apiKey, urlParams, LogEvent$2, this.debug, this.threadCount)) {
+                    yield res;
+                }
+                success = true;
+            }
+            catch (error) {
+                success = true;
+                throw new Error(error.message);
+            }
+        }
+    }
+    /**
+     *
+     * Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.
+     *
+     * @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 {GetLogEventsByAddressQueryParamOpts} queryParamOpts
+     *   - `startingBlock`: The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
+     *   - `endingBlock`: The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async getLogEventsByAddressByPage(chainName, contractAddress, queryParamOpts) {
         let success = false;
         let data;
         let response;
@@ -1626,23 +1961,17 @@ class BaseService {
                 if (queryParamOpts?.endingBlock !== undefined) {
                     urlParams.append("ending-block", queryParamOpts?.endingBlock.toString());
                 }
-                if (queryParamOpts?.address !== undefined) {
-                    urlParams.append("address", queryParamOpts?.address.toString());
-                }
-                if (queryParamOpts?.topics !== undefined) {
-                    urlParams.append("topics", queryParamOpts?.topics.toString());
-                }
-                if (queryParamOpts?.blockHash !== undefined) {
-                    urlParams.append("block-hash", queryParamOpts?.blockHash.toString());
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
                 }
-                if (queryParamOpts?.skipDecode !== undefined) {
-                    urlParams.append("skip-decode", queryParamOpts?.skipDecode.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}/events/?${urlParams}`, {
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/events/address/${contractAddress}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
                         "X-Requested-With": userAgent
@@ -1666,7 +1995,7 @@ class BaseService {
                 else {
                     data = await response.json();
                 }
-                const dataClass = new GetLogsResponse(data.data);
+                const dataClass = new LogEventsByAddressResponse(data.data);
                 checkAndModifyResponse(dataClass);
                 success = true;
                 return {
@@ -1689,18 +2018,19 @@ class BaseService {
     }
     /**
      *
-     * Commonly used to get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.
+     * Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. Useful for cross-sectional analysis of event logs that are emitted on-chain.
      *
      * @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 {GetLogEventsByAddressQueryParamOpts} queryParamOpts
+     * @param {string} topicHash - The endpoint will return event logs that contain this topic hash.
+     * @param {GetLogEventsByTopicHashQueryParamOpts} queryParamOpts
      *   - `startingBlock`: The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
      *   - `endingBlock`: The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`.
+     *   - `secondaryTopics`: Additional topic hash(es) to filter on - padded & unpadded address fields are supported. Separate multiple topics with a comma.
      *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async *getLogEventsByAddress(chainName, contractAddress, queryParamOpts) {
+    async *getLogEventsByTopicHash(chainName, topicHash, queryParamOpts) {
         let success = false;
         let res;
         while (!success) {
@@ -1712,13 +2042,16 @@ class BaseService {
                 if (queryParamOpts?.endingBlock !== undefined) {
                     urlParams.append("ending-block", queryParamOpts?.endingBlock.toString());
                 }
+                if (queryParamOpts?.secondaryTopics !== undefined) {
+                    urlParams.append("secondary-topics", queryParamOpts?.secondaryTopics.toString());
+                }
                 if (queryParamOpts?.pageSize !== undefined) {
                     urlParams.append("page-size", queryParamOpts?.pageSize.toString());
                 }
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of paginateEndpoint$1(`https://api.covalenthq.com/v1/${chainName}/events/address/${contractAddress}/`, this.apiKey, urlParams, LogEvent$2, this.debug, this.threadCount)) {
+                for await (res of paginateEndpoint$1(`https://api.covalenthq.com/v1/${chainName}/events/topics/${topicHash}/`, this.apiKey, urlParams, LogEvent$2, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
@@ -1743,9 +2076,11 @@ class BaseService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    async *getLogEventsByTopicHash(chainName, topicHash, queryParamOpts) {
+    async getLogEventsByTopicHashByPage(chainName, topicHash, queryParamOpts) {
         let success = false;
-        let res;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
@@ -1764,14 +2099,52 @@ class BaseService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of paginateEndpoint$1(`https://api.covalenthq.com/v1/${chainName}/events/topics/${topicHash}/`, this.apiKey, urlParams, LogEvent$2, this.debug, this.threadCount)) {
-                    yield res;
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/events/topics/${topicHash}/?${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 LogEventsByTopicHashResponse(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;
-                throw new Error(error.message);
+                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"
+                };
             }
         }
     }
@@ -1972,6 +2345,15 @@ class BaseService {
     }
 }
 
+class ChainCollectionResponse {
+    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 ChainCollectionItem(itemData)) : null;
+        this.pagination = data.pagination && data.pagination !== null ? new Pagination$1(data.pagination) : null;
+    }
+}
 class ChainCollectionItem {
     constructor(data) {
         this.contract_address = data.contract_address;
@@ -2009,6 +2391,9 @@ class NftTokenContractBalanceItem {
         this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
         this.balance_24h = data.balance_24h;
         this.type = data.type;
+        this.floor_price_quote = data.floor_price_quote;
+        this.pretty_floor_price_quote = data.pretty_floor_price_quote;
+        this.floor_price_native_quote = data.floor_price_native_quote;
         this.nft_data = data.nft_data && data.nft_data !== null ? data.nft_data.map((itemData) => new NftData(itemData)) : null;
     }
 }
@@ -2325,6 +2710,83 @@ class NftService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to fetch the list of NFT collections with downloaded and cached off chain data like token metadata and asset files.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {GetChainCollectionsQueryParamOpts} queryParamOpts
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *   - `noSpam`: If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`.
+     *
+     */
+    async getChainCollectionsByPage(chainName, 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?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
+                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}/nft/collections/?${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 ChainCollectionResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
     /**
      *
      * Commonly used to render the NFTs (including ERC721 and ERC1155) held by an address.
@@ -2453,6 +2915,96 @@ class NftService {
             }
         }
     }
+    /**
+     *
+     * 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 getTokenIdsForContractWithMetadataByPage(chainName, contractAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.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());
+                }
+                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/?${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 a single NFT metadata by token ID from a collection. Useful for building NFT card displays.
@@ -3739,6 +4291,7 @@ class TransactionService {
      * @param {GetTransactionsForBlockQueryParamOpts} 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.
+     *   - `withSafe`: Include safe details.
      *
      */
     async getTransactionsForBlock(chainName, blockHeight, queryParamOpts) {
@@ -3755,6 +4308,9 @@ class TransactionService {
                 if (queryParamOpts?.noLogs !== undefined) {
                     urlParams.append("no-logs", queryParamOpts?.noLogs.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();
@@ -5294,7 +5850,7 @@ class XykService {
     }
 }
 
-const userAgent = "com.covalenthq.sdk.typescript/0.5.2";
+const userAgent = "com.covalenthq.sdk.typescript/0.6.0";
 /**
  * CovalentClient Class
  */