@covalenthq/client-sdk 0.2.9 → 0.4.2

package/dist/services/BalanceService.d.ts

@@ -1,4 +1,4 @@
-import { Chains, Quotes, Response } from "./Client";
+import { Chain, Quote, Response } from "./CovalentClient";
 declare class BalancesResponse {
     /** * The requested address. */
     address: string;
@@ -37,12 +37,20 @@ declare class BalanceItem {
     is_spam: boolean;
     /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
     balance: bigint | null;
+    /** * The 24h asset balance. Use `contract_decimals` to scale this balance for display purposes. */
+    balance_24h: bigint | null;
     /** * The exchange rate for the requested quote currency. */
     quote_rate: number;
+    /** * The 24h exchange rate for the requested quote currency. */
+    quote_rate_24h: number;
     /** * The current balance converted to fiat in `quote-currency`. */
     quote: number;
+    /** * The 24h balance converted to fiat in `quote-currency`. */
+    quote_24h: number;
     /** * A prettier version of the quote for rendering purposes. */
     pretty_quote: string;
+    /** * A prettier version of the 24h quote for rendering purposes. */
+    pretty_quote_24h: string;
     /** * NFT-specific data. */
     nft_data: NftData[];
     constructor(data: BalanceItem);
@@ -123,6 +131,7 @@ declare class HoldingItem {
 declare class OhlcItem {
     /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
     balance: bigint | null;
+    /** * The current balance converted to fiat in `quote-currency`. */
     quote: number;
     /** * A prettier version of the quote for rendering purposes. */
     pretty_quote: string;
@@ -137,10 +146,15 @@ declare class BlockTransactionWithContractTransfers {
     tx_hash: string;
     /** * The offset is the position of the tx in the block. */
     tx_offset: number;
+    /** * Whether or not transaction is successful. */
     successful: boolean;
+    /** * The sender's wallet address. */
     from_address: string;
+    /** * The label of `from` address. */
     from_address_label: string;
+    /** * The receiver's wallet address. */
     to_address: string;
+    /** * The label of `to` address. */
     to_address_label: string;
     /** * The value attached to this tx. */
     value: bigint | null;
@@ -149,7 +163,9 @@ declare class BlockTransactionWithContractTransfers {
     /** * A prettier version of the quote for rendering purposes. */
     pretty_value_quote: string;
     gas_offered: number;
+    /** * The gas spent for this tx. */
     gas_spent: number;
+    /** * The gas price at the time of this tx. */
     gas_price: number;
     /** * The transaction's gas_price * gas_spent, denoted in wei. */
     fees_paid: bigint | null;
@@ -167,9 +183,13 @@ declare class TokenTransferItem {
     block_signed_at: Date;
     /** * The requested transaction hash. */
     tx_hash: string;
+    /** * The sender's wallet address. */
     from_address: string;
+    /** * The label of `from` address. */
     from_address_label: string;
+    /** * The receiver's wallet address. */
     to_address: string;
+    /** * The label of `to` address. */
     to_address_label: string;
     /** * Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. */
     contract_decimals: number;
@@ -181,6 +201,7 @@ declare class TokenTransferItem {
     contract_address: string;
     /** * The contract logo URL. */
     logo_url: string;
+    /** * Categorizes token transactions as either `transfer-in` or `transfer-out`, indicating whether tokens are being received or sent from an account. */
     transfer_type: string;
     /** * The delta attached to this transfer. */
     delta: bigint | null;
@@ -188,14 +209,18 @@ declare class TokenTransferItem {
     balance: bigint | null;
     /** * The exchange rate for the requested quote currency. */
     quote_rate: number;
+    /** * The current delta converted to fiat in `quote-currency`. */
     delta_quote: number;
     /** * A prettier version of the quote for rendering purposes. */
     pretty_delta_quote: string;
+    /** * The current balance converted to fiat in `quote-currency`. */
     balance_quote: number;
+    /** * Additional details on which transfer events were invoked. Defaults to `true`. */
     method_calls: MethodCallsForTransfers[];
     constructor(data: TokenTransferItem);
 }
 declare class MethodCallsForTransfers {
+    /** * The address of the sender. */
     sender_address: string;
     method: string;
     constructor(data: MethodCallsForTransfers);
@@ -277,7 +302,7 @@ declare class HistoricalBalanceItem {
 }
 export interface GetTokenBalancesForWalletAddressQueryParamOpts {
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
-    quoteCurrency?: Quotes;
+    quoteCurrency?: Quote;
     /** * If `true`, NFTs will be included in the response. */
     nft?: boolean;
     /** * If `true`, only NFTs that have been cached will be included in the response. Helpful for faster response times. */
@@ -289,13 +314,13 @@ export interface GetTokenBalancesForWalletAddressQueryParamOpts {
 }
 export interface GetHistoricalPortfolioForWalletAddressQueryParamOpts {
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
-    quoteCurrency?: Quotes;
+    quoteCurrency?: Quote;
     /** * The number of days to return data for. Defaults to 30 days. */
     days?: number;
 }
 export interface GetErc20TransfersForWalletAddressQueryParamOpts {
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
-    quoteCurrency?: Quotes;
+    quoteCurrency?: Quote;
     /** * The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. */
     contractAddress?: string;
     /** * The block height to start from, defaults to `0`. */
@@ -317,7 +342,7 @@ export interface GetTokenHoldersV2ForTokenAddressQueryParamOpts {
 }
 export interface GetHistoricalTokenBalancesForWalletAddressQueryParamOpts {
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
-    quoteCurrency?: Quotes;
+    quoteCurrency?: Quote;
     /** * If `true`, NFTs will be included in the response. */
     nft?: boolean;
     /** * If `true`, only NFTs that have been cached will be included in the response. Helpful for faster response times. */
@@ -337,8 +362,13 @@ export interface GetHistoricalTokenBalancesForWalletAddressQueryParamOpts {
  */
 export declare class BalanceService {
     private apiKey;
-    constructor(apiKey: string);
+    private debug;
+    private threadCount;
+    private LIMIT;
+    constructor(apiKey: string, debug?: boolean, threadCount?: number);
     /**
+     *
+     * Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.
      *
      * @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.
@@ -350,8 +380,10 @@ export declare class BalanceService {
      *   - `noNftAssetMetadata`: If `true`, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs.
      *
      */
-    getTokenBalancesForWalletAddress(chainName: Chains, walletAddress: string, queryParamOpts?: GetTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<BalancesResponse>>;
+    getTokenBalancesForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<BalancesResponse>>;
     /**
+     *
+     * Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.
      *
      * @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.
@@ -360,8 +392,10 @@ export declare class BalanceService {
      *   - `days`: The number of days to return data for. Defaults to 30 days.
      *
      */
-    getHistoricalPortfolioForWalletAddress(chainName: Chains, walletAddress: string, queryParamOpts?: GetHistoricalPortfolioForWalletAddressQueryParamOpts): Promise<Response<PortfolioResponse>>;
+    getHistoricalPortfolioForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetHistoricalPortfolioForWalletAddressQueryParamOpts): Promise<Response<PortfolioResponse>>;
     /**
+     *
+     * 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.
@@ -374,8 +408,10 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getErc20TransfersForWalletAddress(chainName: Chains, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<BlockTransactionWithContractTransfers>;
+    getErc20TransfersForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<BlockTransactionWithContractTransfers>;
     /**
+     *
+     * 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.
@@ -385,8 +421,10 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getTokenHoldersV2ForTokenAddress(chainName: Chains, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): AsyncIterable<TokenHolder>;
+    getTokenHoldersV2ForTokenAddress(chainName: Chain, tokenAddress: string, queryParamOpts?: GetTokenHoldersV2ForTokenAddressQueryParamOpts): AsyncIterable<TokenHolder>;
     /**
+     *
+     * 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.
      *
      * @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.
@@ -400,6 +438,6 @@ export declare class BalanceService {
      *   - `date`: Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
      *
      */
-    getHistoricalTokenBalancesForWalletAddress(chainName: Chains, walletAddress: string, queryParamOpts?: GetHistoricalTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<HistoricalBalancesResponse>>;
+    getHistoricalTokenBalancesForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetHistoricalTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<HistoricalBalancesResponse>>;
 }
 export {};

package/dist/services/BalanceService.js

@@ -1,17 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BalanceService = 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 BalancesResponse {
     constructor(data) {
         this.address = data.address;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
         this.quote_currency = data.quote_currency;
-        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 BalanceItem(itemData)) : null;
     }
 }
@@ -23,14 +21,18 @@ class BalanceItem {
         this.contract_address = data.contract_address;
         this.supports_erc = data.supports_erc;
         this.logo_url = data.logo_url;
-        this.last_transferred_at = data.last_transferred_at && data.last_transferred_at !== null ? (0, date_fns_1.parseISO)(data.last_transferred_at.toString()) : null;
+        this.last_transferred_at = data.last_transferred_at && data.last_transferred_at !== null ? parseISO(data.last_transferred_at.toString()) : null;
         this.native_token = data.native_token;
         this.type = data.type;
         this.is_spam = data.is_spam;
         this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
+        this.balance_24h = data.balance_24h && data.balance_24h !== null ? BigInt(data.balance_24h) : null;
         this.quote_rate = data.quote_rate;
+        this.quote_rate_24h = data.quote_rate_24h;
         this.quote = data.quote;
+        this.quote_24h = data.quote_24h;
         this.pretty_quote = data.pretty_quote;
+        this.pretty_quote_24h = data.pretty_quote_24h;
         this.nft_data = data.nft_data && data.nft_data !== null ? data.nft_data.map((itemData) => new NftData(itemData)) : null;
     }
 }
@@ -70,7 +72,7 @@ class NftCollectionAttribute {
 class PortfolioResponse {
     constructor(data) {
         this.address = data.address;
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
@@ -90,7 +92,7 @@ class PortfolioItem {
 class HoldingItem {
     constructor(data) {
         this.quote_rate = data.quote_rate;
-        this.timestamp = data.timestamp && data.timestamp !== null ? (0, date_fns_1.parseISO)(data.timestamp.toString()) : null;
+        this.timestamp = data.timestamp && data.timestamp !== null ? parseISO(data.timestamp.toString()) : null;
         this.close = data.close && data.close !== null ? new OhlcItem(data.close) : null;
         this.high = data.high && data.high !== null ? new OhlcItem(data.high) : null;
         this.low = data.low && data.low !== null ? new OhlcItem(data.low) : null;
@@ -107,7 +109,7 @@ class OhlcItem {
 class Erc20TransfersResponse {
     constructor(data) {
         this.address = data.address;
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
@@ -117,7 +119,7 @@ class Erc20TransfersResponse {
 }
 class BlockTransactionWithContractTransfers {
     constructor(data) {
-        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? (0, date_fns_1.parseISO)(data.block_signed_at.toString()) : null;
+        this.block_signed_at = data.block_signed_at && data.block_signed_at !== null ? parseISO(data.block_signed_at.toString()) : null;
         this.block_height = data.block_height;
         this.tx_hash = data.tx_hash;
         this.tx_offset = data.tx_offset;
@@ -149,7 +151,7 @@ class Pagination {
 }
 class TokenTransferItem {
     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.tx_hash = data.tx_hash;
         this.from_address = data.from_address;
         this.from_address_label = data.from_address_label;
@@ -178,7 +180,7 @@ class MethodCallsForTransfers {
 }
 class TokenHoldersResponse {
     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 TokenHolder(itemData)) : null;
@@ -202,7 +204,7 @@ class TokenHolder {
 class HistoricalBalancesResponse {
     constructor(data) {
         this.address = data.address;
-        this.updated_at = data.updated_at && data.updated_at !== null ? (0, date_fns_1.parseISO)(data.updated_at.toString()) : null;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
         this.quote_currency = data.quote_currency;
         this.chain_id = data.chain_id;
         this.chain_name = data.chain_name;
@@ -219,7 +221,7 @@ class HistoricalBalanceItem {
         this.logo_url = data.logo_url;
         this.block_height = data.block_height;
         this.last_transferred_block_height = data.last_transferred_block_height;
-        this.last_transferred_at = data.last_transferred_at && data.last_transferred_at !== null ? (0, date_fns_1.parseISO)(data.last_transferred_at.toString()) : null;
+        this.last_transferred_at = data.last_transferred_at && data.last_transferred_at !== null ? parseISO(data.last_transferred_at.toString()) : null;
         this.native_token = data.native_token;
         this.type = data.type;
         this.is_spam = data.is_spam;
@@ -234,11 +236,16 @@ class HistoricalBalanceItem {
  * Balances APIs
  *
  */
-class BalanceService {
-    constructor(apiKey) {
+export class BalanceService {
+    constructor(apiKey, debug = false, threadCount = 3) {
         this.apiKey = apiKey;
+        this.debug = debug;
+        this.threadCount = threadCount;
+        this.LIMIT = pLimit(this.threadCount);
     }
     /**
+     *
+     * Commonly used to fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.
      *
      * @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.
@@ -254,7 +261,7 @@ class BalanceService {
         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();
@@ -273,38 +280,43 @@ class BalanceService {
                 if (queryParamOpts?.noNftAssetMetadata !== undefined) {
                     urlParams.append("no-nft-asset-metadata", queryParamOpts?.noNftAssetMetadata.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_v2/?${urlParams}`, {
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_v2/?${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 BalancesResponse(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 BalancesResponse(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;
@@ -318,6 +330,8 @@ class BalanceService {
         }
     }
     /**
+     *
+     * Commonly used to render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.
      *
      * @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.
@@ -330,7 +344,7 @@ class BalanceService {
         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();
@@ -340,38 +354,43 @@ class BalanceService {
                 if (queryParamOpts?.days !== undefined) {
                     urlParams.append("days", queryParamOpts?.days.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/portfolio_v2/?${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}/portfolio_v2/?${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 PortfolioResponse(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 PortfolioResponse(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;
@@ -385,6 +404,8 @@ 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.
@@ -421,18 +442,20 @@ class BalanceService {
                 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}/address/${walletAddress}/transfers_v2/`, this.apiKey, urlParams, BlockTransactionWithContractTransfers)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/`, this.apiKey, urlParams, BlockTransactionWithContractTransfers, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * 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.
@@ -457,18 +480,20 @@ class BalanceService {
                 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}/tokens/${tokenAddress}/token_holders_v2/`, this.apiKey, urlParams, TokenHolder)) {
+                for await (res of paginateEndpoint(`https://api.covalenthq.com/v1/${chainName}/tokens/${tokenAddress}/token_holders_v2/`, this.apiKey, urlParams, TokenHolder, this.debug, this.threadCount)) {
                     yield res;
                 }
                 success = true;
             }
             catch (error) {
                 success = true;
-                return res;
+                throw new Error(error.message);
             }
         }
     }
     /**
+     *
+     * 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.
      *
      * @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.
@@ -486,7 +511,7 @@ class BalanceService {
         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();
@@ -511,38 +536,43 @@ class BalanceService {
                 if (queryParamOpts?.date !== undefined) {
                     urlParams.append("date", queryParamOpts?.date.toString());
                 }
-                response = await fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/historical_balances/?${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}/historical_balances/?${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 HistoricalBalancesResponse(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 HistoricalBalancesResponse(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;
@@ -556,5 +586,4 @@ class BalanceService {
         }
     }
 }
-exports.BalanceService = BalanceService;
 //# sourceMappingURL=BalanceService.js.map