@covalenthq/client-sdk 0.2.8 → 0.4.2

package/dist/services/BaseService.js

@@ -1,13 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseService = void 0;
-const Client_1 = require("./Client");
-const ApiHelpers_1 = require("../util/ApiHelpers");
-const date_fns_1 = require("date-fns");
-const backoff_1 = require("../util/backoff");
+import { userAgent } from "./CovalentClient";
+import { checkAndModifyResponse, debugOutput, paginateEndpoint } from "../util/ApiHelpers";
+import { parseISO } from "date-fns";
+import { ExponentialBackoff } from "../util/backoff";
+import pLimit from "p-limit";
 class BlockResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new Block(itemData)) : null;
@@ -15,13 +13,13 @@ class BlockResponse {
 }
 class Block {
     constructor(data) {
-        this.signed_at = data.signed_at && data.signed_at !== null ? (0, date_fns_1.parseISO)(data.signed_at.toString()) : null;
+        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 ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new ResolvedAddressItem(itemData)) : null;
@@ -35,7 +33,7 @@ class ResolvedAddressItem {
 }
 class BlockHeightsResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new Block(itemData)) : null;
@@ -52,7 +50,7 @@ class Pagination {
 }
 class GetLogsResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new GetLogsEvent(itemData)) : null;
@@ -60,7 +58,7 @@ class GetLogsResponse {
 }
 class GetLogsEvent {
     constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? (0, date_fns_1.parseISO)(data.block_signed_at.toString()) : null;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
         this.block_height = data.block_height;
         this.block_hash = data.block_hash;
         this.tx_offset = data.tx_offset;
@@ -95,7 +93,7 @@ class Param {
 }
 class LogEventsByAddressResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new LogEvent(itemData)) : null;
@@ -104,7 +102,7 @@ class LogEventsByAddressResponse {
 }
 class LogEvent {
     constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? (0, date_fns_1.parseISO)(data.block_signed_at.toString()) : null;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
         this.block_height = data.block_height;
         this.tx_offset = data.tx_offset;
         this.log_offset = data.log_offset;
@@ -122,7 +120,7 @@ class LogEvent {
 }
 class LogEventsByTopicHashResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new LogEvent(itemData)) : null;
@@ -131,7 +129,7 @@ class LogEventsByTopicHashResponse {
 }
 class AllChainsResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new ChainItem(itemData)) : null;
     }
 }
@@ -152,7 +150,7 @@ class ChainItem {
 }
 class AllChainsStatusResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new ChainStatusItem(itemData)) : null;
     }
 }
@@ -166,13 +164,13 @@ class ChainStatusItem {
         this.white_logo_url = data.white_logo_url;
         this.is_appchain = data.is_appchain;
         this.synced_block_height = data.synced_block_height;
-        this.synced_blocked_signed_at = data.synced_blocked_signed_at && data.synced_blocked_signed_at !== null ? (0, date_fns_1.parseISO)(data.synced_blocked_signed_at.toString()) : null;
+        this.synced_blocked_signed_at = data.synced_blocked_signed_at && data.synced_blocked_signed_at !== null ? parseISO(data.synced_blocked_signed_at.toString()) : null;
         this.has_data = data.has_data;
     }
 }
 class ChainActivityResponse {
     constructor(data) {
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.address = data.address;
         this.items = data.items && data.items !== null ? data.items.map((itemData) => new ChainActivityEvent(itemData)) : null;
     }
@@ -180,18 +178,23 @@ class ChainActivityResponse {
 class ChainActivityEvent extends ChainItem {
     constructor(data) {
         super(data);
-        this.last_seen_at = data.last_seen_at && data.last_seen_at !== null ? (0, date_fns_1.parseISO)(data.last_seen_at.toString()) : null;
+        this.last_seen_at = data.last_seen_at && data.last_seen_at !== null ? parseISO(data.last_seen_at.toString()) : null;
     }
 }
 /**
  * Class A - Base
  *
  */
-class BaseService {
-    constructor(apiKey) {
+export class BaseService {
+    constructor(apiKey, debug = false, threadCount = 3) {
         this.apiKey = apiKey;
+        this.debug = debug;
+        this.threadCount = threadCount;
+        this.LIMIT = pLimit(this.threadCount);
     }
     /**
+     *
+     * Commonly used to fetch and render a single block for a block explorer.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {string} blockHeight - The block height or `latest` for the latest block available.
@@ -201,42 +204,47 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/block_v2/${blockHeight}/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/block_v2/${blockHeight}/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new BlockResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new BlockResponse(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"
+                };
             }
             catch (error) {
                 success = true;
@@ -250,6 +258,8 @@ class BaseService {
         }
     }
     /**
+     *
+     * Commonly used to resolve ENS, RNS and Unstoppable Domains addresses.
      *
      * @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.
@@ -259,42 +269,47 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/resolve_address/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/resolve_address/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new ResolvedAddress(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new ResolvedAddress(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"
+                };
             }
             catch (error) {
                 success = true;
@@ -308,6 +323,8 @@ 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.
@@ -329,18 +346,20 @@ class BaseService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of (0, ApiHelpers_1.paginateEndpoint)(`https://api.covalenthq.com/v1/${chainName}/block_v2/${startDate}/${endDate}/`, this.apiKey, urlParams, Block)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/block_v2/${startDate}/${endDate}/`, this.apiKey, urlParams, Block, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * 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.
      *
      * @param {string} chainName - The chain name eg: `eth-mainnet`.
      * @param {GetLogsQueryParamOpts} queryParamOpts
@@ -356,7 +375,7 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
@@ -378,38 +397,43 @@ class BaseService {
                 if (queryParamOpts?.skipDecode !== undefined) {
                     urlParams.append("skip-decode", queryParamOpts?.skipDecode.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/events/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/events/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new GetLogsResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new 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 : "401 Authorization Required"
+                };
             }
             catch (error) {
                 success = true;
@@ -423,6 +447,8 @@ 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.
      *
      * @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.
@@ -451,25 +477,27 @@ class BaseService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of (0, ApiHelpers_1.paginateEndpoint)(`https://api.covalenthq.com/v1/${chainName}/events/address/${contractAddress}/`, this.apiKey, urlParams, LogEvent)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/events/address/${contractAddress}/`, this.apiKey, urlParams, LogEvent, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * 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} 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.
+     *   - `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.
      *
@@ -495,18 +523,20 @@ class BaseService {
                 if (queryParamOpts?.pageNumber !== undefined) {
                     urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
                 }
-                for await (res of (0, ApiHelpers_1.paginateEndpoint)(`https://api.covalenthq.com/v1/${chainName}/events/topics/${topicHash}/`, this.apiKey, urlParams, LogEvent)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/events/topics/${topicHash}/`, this.apiKey, urlParams, LogEvent, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * Commonly used to build internal dashboards for all supported chains on Covalent.
      *
      *
      */
@@ -514,42 +544,47 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/chains/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/chains/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new AllChainsResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new AllChainsResponse(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"
+                };
             }
             catch (error) {
                 success = true;
@@ -563,6 +598,8 @@ class BaseService {
         }
     }
     /**
+     *
+     * Commonly used to build internal status dashboards of all supported chains.
      *
      *
      */
@@ -570,42 +607,47 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
-                response = await fetch(`https://api.covalenthq.com/v1/chains/status/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/chains/status/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new AllChainsStatusResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new AllChainsStatusResponse(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"
+                };
             }
             catch (error) {
                 success = true;
@@ -619,6 +661,8 @@ class BaseService {
         }
     }
     /**
+     *
+     * Commonly used to locate chains which an address is active on with a single API call.
      *
      * @param {string} walletAddress - The requested wallet address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
      * @param {GetAddressActivityQueryParamOpts} queryParamOpts
@@ -629,45 +673,50 @@ class BaseService {
         let success = false;
         let data;
         let response;
-        const backoff = new backoff_1.ExponentialBackoff();
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
         while (!success) {
             try {
                 const urlParams = new URLSearchParams();
                 if (queryParamOpts?.testnets !== undefined) {
                     urlParams.append("testnets", queryParamOpts?.testnets.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/address/${walletAddress}/activity/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/address/${walletAddress}/activity/?${urlParams}`, {
                     headers: {
                         "Authorization": `Bearer ${this.apiKey}`,
-                        "X-Requested-With": Client_1.userAgent
+                        "X-Requested-With": userAgent
                     }
-                });
-                data = await response.json();
-                if (data.error && data.error_code === 429) {
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
                     try {
-                        await backoff.backOff();
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
                     }
                     catch (error) {
                         success = true;
                         return {
                             data: null,
-                            error: data.error,
-                            error_code: data ? data.error_code : response.status,
-                            error_message: data ? data.error_message : "401 Authorization Required"
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
                         };
                     }
                 }
                 else {
-                    const dataClass = new ChainActivityResponse(data.data);
-                    (0, ApiHelpers_1.checkAndModifyResponse)(dataClass);
-                    success = true;
-                    return {
-                        data: dataClass,
-                        error: data.error,
-                        error_code: data ? data.error_code : response.status,
-                        error_message: data ? data.error_message : "401 Authorization Required"
-                    };
+                    data = await response.json();
                 }
+                const dataClass = new ChainActivityResponse(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"
+                };
             }
             catch (error) {
                 success = true;
@@ -681,5 +730,4 @@ class BaseService {
         }
     }
 }
-exports.BaseService = BaseService;
 //# sourceMappingURL=BaseService.js.map