@covalenthq/client-sdk 0.4.2 → 0.5.2

package/dist/esm/util/types/BalanceServiceTypes.d.ts

@@ -282,3 +282,41 @@ export interface HistoricalBalanceItem {
     /** * NFT-specific data. */
     nft_data: NftData[];
 }
+export interface TokenBalanceNativeResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * List of response items. */
+    items: NativeBalanceItem[];
+}
+export interface NativeBalanceItem {
+    /** * Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. */
+    contract_decimals: number;
+    /** * The string returned by the `name()` method. */
+    contract_name: string;
+    /** * The ticker symbol for this contract. This field is set by a developer and non-unique across a network. */
+    contract_ticker_symbol: string;
+    /** * Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. */
+    contract_address: string;
+    /** * A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. */
+    supports_erc: string;
+    /** * The contract logo URL. */
+    logo_url: string;
+    /** * The height of the block. */
+    block_height: number;
+    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
+    balance: bigint | null;
+    /** * The exchange rate for the requested quote currency. */
+    quote_rate: number;
+    /** * The current balance converted to fiat in `quote-currency`. */
+    quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_quote: string;
+}

package/dist/esm/util/types/BaseServiceTypes.d.ts

@@ -133,11 +133,27 @@ export interface ChainItem {
     black_logo_url: string;
     /** * A white png logo url for the chain. */
     white_logo_url: string;
+    /** * The color theme for the chain. */
+    color_theme: ColorTheme;
     /** * True if the chain is an AppChain. */
     is_appchain: boolean;
     /** * The ChainItem the appchain is a part of. */
     appchain_of: ChainItem;
 }
+export interface ColorTheme {
+    /** * The red color code. */
+    red: number;
+    /** * The green color code. */
+    green: number;
+    /** * The blue color code. */
+    blue: number;
+    /** * The alpha color code. */
+    alpha: number;
+    /** * The hexadecimal color code. */
+    hex: string;
+    /** * The color represented in css rgb() functional notation. */
+    css_rgb: string;
+}
 export interface AllChainsStatusResponse {
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;

package/dist/esm/util/types/NftServiceTypes.d.ts

@@ -219,3 +219,79 @@ export interface NftOwnershipForCollectionItem {
     type: string;
     nft_data: NftData;
 }
+export interface NftMarketSaleCountResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested address. */
+    address: string;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * List of response items. */
+    items: MarketSaleCountItem[];
+}
+export interface MarketSaleCountItem {
+    /** * The timestamp of the date of sale. */
+    date: Date;
+    /** * The total amount of sales for the current day. */
+    sale_count: number;
+}
+export interface NftMarketVolumeResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested address. */
+    address: string;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * List of response items. */
+    items: MarketVolumeItem[];
+}
+export interface MarketVolumeItem {
+    /** * The timestamp of the date of sale. */
+    date: Date;
+    /** * The ticker symbol for the native currency. */
+    native_ticker_symbol: string;
+    /** * The contract name of the native currency. */
+    native_name: string;
+    /** * The current volume converted to fiat in `quote-currency`. */
+    volume_quote: number;
+    /** * The current volume in native currency. */
+    volume_native_quote: number;
+    /** * A prettier version of the volume quote for rendering purposes. */
+    pretty_volume_quote: string;
+}
+export interface NftMarketFloorPriceResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested address. */
+    address: string;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * List of response items. */
+    items: MarketFloorPriceItem[];
+}
+export interface MarketFloorPriceItem {
+    /** * The timestamp of the date of sale. */
+    date: Date;
+    /** * The ticker symbol for the native currency. */
+    native_ticker_symbol: string;
+    /** * The contract name of the native currency. */
+    native_name: string;
+    /** * The current floor price in native currency. */
+    floor_price_native_quote: number;
+    /** * The current floor price converted to fiat in `quote-currency`. */
+    floor_price_quote: number;
+    /** * A prettier version of the floor price quote for rendering purposes. */
+    pretty_floor_price_quote: string;
+}

package/dist/esm/util/types/SecurityServiceTypes.d.ts

@@ -69,3 +69,53 @@ export interface TokenSpenderItem {
     pretty_value_at_risk_quote: string;
     risk_factor: string;
 }
+export interface NftApprovalsResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested address. */
+    address: string;
+    /** * List of response items. */
+    items: NftApprovalsItem[];
+}
+export interface NftApprovalsItem {
+    /** * Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. */
+    contract_address: string;
+    /** * The label of the contract address. */
+    contract_address_label: string;
+    /** * The ticker symbol for this contract. This field is set by a developer and non-unique across a network. */
+    contract_ticker_symbol: string;
+    /** * List of asset balances held by the user. */
+    token_balances: NftApprovalBalance[];
+    /** * Contracts with non-zero approvals for this token. */
+    spenders: NftApprovalSpender[];
+}
+export interface NftApprovalBalance {
+    /** * The token's id. */
+    token_id: bigint | null;
+    /** * The NFT's token balance. */
+    token_balance: bigint | null;
+}
+export interface NftApprovalSpender {
+    /** * The height of the block. */
+    block_height: number;
+    /** * The offset is the position of the tx in the block. */
+    tx_offset: number;
+    /** * The offset is the position of the log entry within an event log." */
+    log_offset: number;
+    /** * The block signed timestamp in UTC. */
+    block_signed_at: Date;
+    /** * Most recent transaction that updated approval amounts for the token. */
+    tx_hash: string;
+    /** * Address of the contract with approval for the token. */
+    spender_address: string;
+    /** * Name of the contract with approval for the token. */
+    spender_address_label: string;
+    /** * The token ids approved. */
+    token_ids_approved: string;
+    /** * Remaining number of tokens granted to the spender by the approval. */
+    allowance: string;
+}

package/dist/esm/util/types/TransactionServiceTypes.d.ts

@@ -61,6 +61,8 @@ export interface Transaction {
     lending_details: LendingReport;
     /** * The log events. */
     log_events: LogEvent[];
+    /** * The details related to the safe transaction. */
+    safe_details: SafeDetails[];
 }
 export interface DexReport {
     /** * The offset is the position of the log entry within an event log. */
@@ -249,6 +251,14 @@ export interface LendingReport {
     /** * Stores the wallet address of the user initiating the event. */
     user: string;
 }
+export interface SafeDetails {
+    /** * The address that signed the safe transaction. */
+    owner_address: string;
+    /** * The signature of the owner for the safe transaction. */
+    signature: string;
+    /** * The type of safe signature used. */
+    signature_type: string;
+}
 export interface RecentTransactionsResponse {
     /** * The requested address. */
     address: string;
@@ -310,3 +320,20 @@ export interface TransactionSummary {
     /** * The link to the transaction details using the Covalent API. */
     tx_detail_link: string;
 }
+export interface TransactionsResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The current page of the response. */
+    current_page: number;
+    links: PaginationLinks;
+    /** * List of response items. */
+    items: Transaction[];
+}

package/dist/services/BalanceService.d.ts

@@ -137,6 +137,23 @@ declare class OhlcItem {
     pretty_quote: string;
     constructor(data: OhlcItem);
 }
+declare class Erc20TransfersResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * List of response items. */
+    items: BlockTransactionWithContractTransfers[];
+    /** * Pagination metadata. */
+    pagination: Pagination;
+    constructor(data: Erc20TransfersResponse);
+}
 declare class BlockTransactionWithContractTransfers {
     /** * The block signed timestamp in UTC. */
     block_signed_at: Date;
@@ -178,6 +195,17 @@ declare class BlockTransactionWithContractTransfers {
     transfers: TokenTransferItem[];
     constructor(data: BlockTransactionWithContractTransfers);
 }
+declare class Pagination {
+    /** * True is there is another page. */
+    has_more: boolean;
+    /** * The requested page number. */
+    page_number: number;
+    /** * The requested number of items on the current page. */
+    page_size: number;
+    /** * The total number of items across all pages for this request. */
+    total_count: number;
+    constructor(data: Pagination);
+}
 declare class TokenTransferItem {
     /** * The block signed timestamp in UTC. */
     block_signed_at: Date;
@@ -300,6 +328,46 @@ declare class HistoricalBalanceItem {
     nft_data: NftData[];
     constructor(data: HistoricalBalanceItem);
 }
+declare class TokenBalanceNativeResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * List of response items. */
+    items: NativeBalanceItem[];
+    constructor(data: TokenBalanceNativeResponse);
+}
+declare class NativeBalanceItem {
+    /** * Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. */
+    contract_decimals: number;
+    /** * The string returned by the `name()` method. */
+    contract_name: string;
+    /** * The ticker symbol for this contract. This field is set by a developer and non-unique across a network. */
+    contract_ticker_symbol: string;
+    /** * Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. */
+    contract_address: string;
+    /** * A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. */
+    supports_erc: string;
+    /** * The contract logo URL. */
+    logo_url: string;
+    /** * The height of the block. */
+    block_height: number;
+    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
+    balance: bigint | null;
+    /** * The exchange rate for the requested quote currency. */
+    quote_rate: number;
+    /** * The current balance converted to fiat in `quote-currency`. */
+    quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_quote: string;
+    constructor(data: NativeBalanceItem);
+}
 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?: Quote;
@@ -356,6 +424,12 @@ export interface GetHistoricalTokenBalancesForWalletAddressQueryParamOpts {
     /** * Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. */
     date?: number;
 }
+export interface GetNativeTokenBalanceQueryParamOpts {
+    /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
+    quoteCurrency?: Quote;
+    /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
+    blockHeight?: number;
+}
 /**
  * Balances APIs
  *
@@ -409,6 +483,22 @@ export declare class BalanceService {
      *
      */
     getErc20TransfersForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<BlockTransactionWithContractTransfers>;
+    /**
+     *
+     * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetErc20TransfersForWalletAddressQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `contractAddress`: The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     *   - `startingBlock`: The block height to start from, defaults to `0`.
+     *   - `endingBlock`: The block height to end at, defaults to current block height.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    getErc20TransfersForWalletAddressByPage(chainName: Chain, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): Promise<Response<Erc20TransfersResponse>>;
     /**
      *
      * 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.
@@ -439,5 +529,15 @@ export declare class BalanceService {
      *
      */
     getHistoricalTokenBalancesForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetHistoricalTokenBalancesForWalletAddressQueryParamOpts): Promise<Response<HistoricalBalancesResponse>>;
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetNativeTokenBalanceQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     *
+     */
+    getNativeTokenBalance(chainName: Chain, walletAddress: string, queryParamOpts?: GetNativeTokenBalanceQueryParamOpts): Promise<Response<TokenBalanceNativeResponse>>;
 }
 export {};

package/dist/services/BalanceService.js

@@ -232,6 +232,31 @@ class HistoricalBalanceItem {
         this.nft_data = data.nft_data && data.nft_data !== null ? data.nft_data.map((itemData) => new NftData(itemData)) : null;
     }
 }
+class TokenBalanceNativeResponse {
+    constructor(data) {
+        this.address = data.address;
+        this.updated_at = data.updated_at && data.updated_at !== null ? parseISO(data.updated_at.toString()) : null;
+        this.quote_currency = data.quote_currency;
+        this.chain_id = data.chain_id;
+        this.chain_name = data.chain_name;
+        this.items = data.items && data.items !== null ? data.items.map((itemData) => new NativeBalanceItem(itemData)) : null;
+    }
+}
+class NativeBalanceItem {
+    constructor(data) {
+        this.contract_decimals = data.contract_decimals;
+        this.contract_name = data.contract_name;
+        this.contract_ticker_symbol = data.contract_ticker_symbol;
+        this.contract_address = data.contract_address;
+        this.supports_erc = data.supports_erc;
+        this.logo_url = data.logo_url;
+        this.block_height = data.block_height;
+        this.balance = data.balance && data.balance !== null ? BigInt(data.balance) : null;
+        this.quote_rate = data.quote_rate;
+        this.quote = data.quote;
+        this.pretty_quote = data.pretty_quote;
+    }
+}
 /**
  * Balances APIs
  *
@@ -315,7 +340,7 @@ export class BalanceService {
                     data: dataClass,
                     error: data.error,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -324,7 +349,7 @@ export class BalanceService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
@@ -389,7 +414,7 @@ export class BalanceService {
                     data: dataClass,
                     error: data.error,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -398,7 +423,7 @@ export class BalanceService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }
@@ -453,6 +478,96 @@ export class BalanceService {
             }
         }
     }
+    /**
+     *
+     * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetErc20TransfersForWalletAddressQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `contractAddress`: The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     *   - `startingBlock`: The block height to start from, defaults to `0`.
+     *   - `endingBlock`: The block height to end at, defaults to current block height.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     *
+     */
+    async getErc20TransfersForWalletAddressByPage(chainName, walletAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.contractAddress !== undefined) {
+                    urlParams.append("contract-address", queryParamOpts?.contractAddress.toString());
+                }
+                if (queryParamOpts?.startingBlock !== undefined) {
+                    urlParams.append("starting-block", queryParamOpts?.startingBlock.toString());
+                }
+                if (queryParamOpts?.endingBlock !== undefined) {
+                    urlParams.append("ending-block", queryParamOpts?.endingBlock.toString());
+                }
+                if (queryParamOpts?.pageSize !== undefined) {
+                    urlParams.append("page-size", queryParamOpts?.pageSize.toString());
+                }
+                if (queryParamOpts?.pageNumber !== undefined) {
+                    urlParams.append("page-number", queryParamOpts?.pageNumber.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/transfers_v2/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": userAgent
+                    }
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new Erc20TransfersResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
     /**
      *
      * Commonly used to get a list of all the token holders for a specified ERC20 or ERC721 token. Returns historic token holders when block-height is set (defaults to `latest`). Useful for building pie charts of token holders.
@@ -571,7 +686,79 @@ export class BalanceService {
                     data: dataClass,
                     error: data.error,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+            catch (error) {
+                success = true;
+                return {
+                    data: null,
+                    error: true,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
+                };
+            }
+        }
+    }
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetNativeTokenBalanceQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `blockHeight`: Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     *
+     */
+    async getNativeTokenBalance(chainName, walletAddress, queryParamOpts) {
+        let success = false;
+        let data;
+        let response;
+        const backoff = new ExponentialBackoff(this.apiKey, this.debug);
+        while (!success) {
+            try {
+                const urlParams = new URLSearchParams();
+                if (queryParamOpts?.quoteCurrency !== undefined) {
+                    urlParams.append("quote-currency", queryParamOpts?.quoteCurrency.toString());
+                }
+                if (queryParamOpts?.blockHeight !== undefined) {
+                    urlParams.append("block-height", queryParamOpts?.blockHeight.toString());
+                }
+                let startTime;
+                if (this.debug) {
+                    startTime = typeof performance !== 'undefined' ? performance.now() : process.hrtime();
+                }
+                response = await this.LIMIT(() => fetch(`https://api.covalenthq.com/v1/${chainName}/address/${walletAddress}/balances_native/?${urlParams}`, {
+                    headers: {
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        "X-Requested-With": userAgent
+                    }
+                }));
+                debugOutput(response.url, response.status, startTime);
+                if (response.status === 429) {
+                    try {
+                        data = await this.LIMIT(() => backoff.backOff(response.url));
+                    }
+                    catch (error) {
+                        success = true;
+                        return {
+                            data: null,
+                            error: true,
+                            error_code: response.status,
+                            error_message: error.message
+                        };
+                    }
+                }
+                else {
+                    data = await response.json();
+                }
+                const dataClass = new TokenBalanceNativeResponse(data.data);
+                checkAndModifyResponse(dataClass);
+                success = true;
+                return {
+                    data: dataClass,
+                    error: data.error,
+                    error_code: data ? data.error_code : response.status,
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
             catch (error) {
@@ -580,7 +767,7 @@ export class BalanceService {
                     data: null,
                     error: true,
                     error_code: data ? data.error_code : response.status,
-                    error_message: data ? data.error_message : "401 Authorization Required"
+                    error_message: data ? data.error_message : response.status === 500 ? "Internal server error" : "401 Authorization Required"
                 };
             }
         }