@covalenthq/client-sdk 0.1.2 → 0.1.4

package/README.md

@@ -25,7 +25,7 @@ import { Client } from "@covalenthq/client-sdk";
 
 const ApiServices = async () => {
     const client = new Client("YOUR_API_KEY"); // Replace with your Covalent API key.
-    const resp = await client.BalancesService.getTokenBalances("eth-mainnet", "WALLET_ADDRESS"); // Example call, refer to API Docs for required paramaters or click into the method `getTokenBalances` to see the accepted parameter arguments
+    const resp = await client.BalanceService.getTokenBalancesForWalletAddress("eth-mainnet", "WALLET_ADDRESS"); // Example call, refer to API Docs for required paramaters or click into the method `getTokenBalancesForWalletAddress` to see the accepted parameter arguments
     console.log(resp.data);
 }
 ```
@@ -39,54 +39,43 @@ const ApiServices = async () => {
 
 The Covalent SDK provides comprehensive support for all Class A, Class B, and Pricing endpoints grouped under various Services, offering a wide range of functionalities and capabilities:
 
-- `ApprovalService`: Access to the Covalent's getApprovals endpoint
-- `BalancesService`: Access to the Covalent's balances endpoints
+- `SecurityService`: Access to the Covalent's getApprovals endpoint
+- `BalanceService`: Access to the Covalent's balances endpoints
 - `BaseServices`: Access to the Covalent's log events, chain, and block endpoints
-- `LogEventService`: Access to the Covalent's get logs endpoint
-- `NameResolverService`: Access to the Covalent's get resolved address for registered address endpoint
 - `NftService`: Access to the Covalent's NFT endpoints
 - `PricingService`: Access to the Covalent's get historical token prices endpoint
-- `TransactionsService`: Access to the Covalent's transactions endpoints (with pagination)
+- `TransactionService`: Access to the Covalent's transactions endpoints (with pagination)
 - `XykService`: Access to the Covalent's Xy=k endpoints
 
-### ApprovalService
+### SecurityService
 
-The `ApprovalService` class contains the getApprovals() endpoint, refer to the [getApprovals endpoint on our API docs](https://www.covalenthq.com/docs/api/security/get-token-approvals-for-address/).
+The `SecurityService` class contains the getApprovals() endpoint, refer to the [getApprovals endpoint on our API docs](https://www.covalenthq.com/docs/api/security/get-token-approvals-for-address/).
 
 - `getApprovals()`: Get a list of approvals across all token contracts categorized by spenders for a wallet’s assets.
 
-### BalancesService
+### BalanceService
 
-The `BalancesService` class contains the balances endpoints. Listed below are the supported endpoints, also refer to our api docs under the Balances section in our class A endpoints.
+The `BalanceService` class contains the balances endpoints. Listed below are the supported endpoints, also refer to our api docs under the Balances section in our class A endpoints.
 
-- `getTokenBalances()`: Fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.
-- `getAddressPortfolio()`: Render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.
-- `getErc20Transfers()`: Render the transfer-in and transfer-out of a token along with historical prices from an address.
-- `getTokenHoldersV2()`: 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.
+- `getTokenBalancesForWalletAddress()`: Fetch the native, fungible (ERC20), and non-fungible (ERC721 & ERC1155) tokens held by an address. Response includes spot prices and other metadata.
+- `getHistoricalTokenBalancesForWalletAddress()`: 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.
+- `getHistoricalPortfolioForWalletAddress()`: Render a daily portfolio balance for an address broken down by the token. The timeframe is user-configurable, defaults to 30 days.
+- `getErc20TransfersForWalletAddress()`: Render the transfer-in and transfer-out of a token along with historical prices from an address.
+- `getTokenHoldersV2ForTokenAddress()`: 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.
 
 ### BaseServices
 
 The `BaseServices` class contains the log events, chain, and block endpoints. Listed below are the supported endpoints, also refer to our api docs under the Base section in our class A endpoints.
 
 - `getBlock()`: Fetch and render a single block for a block explorer.
+- `getLogs()`: Get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.
+- `getResolvedAddress()`: Used to resolve ENS, RNS and Unstoppable Domains addresses.
 - `getBlockHeights()`: Get all the block heights within a particular date range. Useful for rendering a display where you sort blocks by day.
 - `getLogEventsByAddress()`: Get all the event logs emitted from a particular contract address. Useful for building dashboards that examine on-chain interactions.
 - `getLogEventsByTopicHash()`: 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.
 - `getAllChains()`: Used to build internal dashboards for all supported chains on Covalent.
 - `getAllChainStatus()`: Used to build internal status dashboards of all supported chains.
 
-### LogEventService
-
-The `LogEventService` class contains the getLogs() endpoint. Refer to the [getLogs endpoint on our API docs](https://www.covalenthq.com/docs/api/base/get-logs/).
-
-- `getLogs()`: Get all the event logs of the latest block, or for a range of blocks. Includes sender contract metadata as well as decoded logs.
-
-### NameResolverService
-
-The `NameResolverService` class contains the getResolvedAddress() endpoint. Refer to the [getResolvedAddress endpoint on our API docs](https://www.covalenthq.com/docs/api/base/get-resolved-address-for-registered-address/).
-
-- `getResolvedAddress()`: Used to resolve ENS, RNS and Unstoppable Domains addresses.
-
 ### NftService
 
 The `NftService` class contains the NFT endpoints. Listed below are the supported endpoints, also refer to our api docs under the NFT section in our class A endpoints.
@@ -109,9 +98,9 @@ The `PricingService` class contains the getTokenPrices() endpoint. Refer to the
 
 - `getTokenPrices()`: Get historic prices of a token between date ranges. Supports native tokens.
 
-### TransactionsService
+### TransactionService
 
-The `TransactionsService` class contains the transactions endpoint. Listed below are the supported endpoints, also refer to our api docs under the Transactions section in our class A endpoints.
+The `TransactionService` class contains the transactions endpoint. Listed below are the supported endpoints, also refer to our api docs under the Transactions section in our class A endpoints.
 
 - `getRecentTransactionsForAddress()`: Fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.
 - `getTransaction()`: Fetch and render a single transaction including its decoded log events. Additionally return semantically decoded information for DEX trades, lending and NFT sales.
@@ -136,14 +125,14 @@ The `XykService` class contains the Xy=k endpoints. Listed below are the support
 
 ### How pagination works
 
-The Covalent getRecentTransactionsForAddress() endpoint is currently the only endpoint that supports pagination which return 100 results per page. To get the next page, it uses a link url that is grabbed from the previous call. Here's an example of how to paginate through all recent transactions on the ethereum blockchain for the demo's ENS address:
+The Covalent `getRecentTransactionsForAddress()` endpoint is currently the only endpoint that supports pagination which return 100 results per page. To get the next page, it uses a link url that is grabbed from the previous call. Here's an example of how to paginate through all recent transactions on the ethereum blockchain for the demo's ENS address:
 
 ```ts
 import { Client } from "@covalenthq/client-sdk";
 
 const ApiServices = async () => {
     const client = new Client("YOUR_API_KEY"); // Replace with your Covalent API key.
-    for await (const resp of client.TransactionsService.getRecentTransactionsForAddress("eth-mainnet", "demo.eth")) {
+    for await (const resp of client.TransactionService.getRecentTransactionsForAddress("eth-mainnet", "demo.eth")) {
         console.log("resp", resp);
     }
 }
@@ -153,6 +142,30 @@ const ApiServices = async () => {
 
 Each endpoint is equipped with an exponential backoff algorithm that exponentially extends the wait time between retries, making up to a `maximum of 5` retry attempts only.
 
+### Error codes
+Covalent uses standard HTTP response codes to indicate the success or failure of an API request. In general: codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, etc.). Codes in the 5xx range indicate an error with Covalent's servers (these are rare).
+
+| Code      | Description |
+| ----------- | ----------- |
+| 200      | OK	Everything worked as expected.       |
+| 400   | Bad Request	The request could not be accepted, usually due to a missing required parameter.        |
+| 401   | Unauthorized	No valid API key was provided.        |
+| 404   | Not Found	The request path does not exist.        |
+| 429   | Too Many Requests	You are being rate-limited. Please see the rate limiting section for more information.        |
+| 500, 502, 503   | Server Errors	Something went wrong on Covalent's servers. These are rare.        |
+
+## Tests
+to run all tests, you need to input your api key first shown below
+```
+COVALENT_API_KEY=YOUR_KEY npm test
+```
+OR
+
+you can run individual tests for each service, for example
+```
+COVALENT_API_KEY=YOUR_KEY npm test -- security-service.test.ts
+```
+
 ## Documentation
 
-The Covalent API SDK documentation is integrated within the source code through `tsdoc` comments. When utilizing an Integrated Development Environment (IDE), the SDK provides generated types and accompanying documentation for seamless reference and usage.
+The Covalent API SDK documentation is integrated within the source code through `tsdoc` comments. When utilizing an Integrated Development Environment (IDE), the SDK provides generated types and accompanying documentation for seamless reference and usage.

package/dist/services/BalanceService.d.ts

@@ -0,0 +1,390 @@
+import { Chains } from "./Client";
+import { Quotes } from "./Client";
+declare class BalancesResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: number;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: string;
+    /** * The requested quote currency eg: `USD`. */
+    quote_currency: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: string;
+    /** * List of response items. */
+    items: BalanceItem[];
+    constructor(data: BalancesResponse);
+}
+declare class BalanceItem {
+    /** * 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 timestamp when the token was transferred. */
+    last_transferred_at: string;
+    /** * Indicates if a token is the chain's native gas token, eg: ETH on Ethereum. */
+    native_token: boolean;
+    /** * One of `cryptocurrency`, `stablecoin`, `nft` or `dust`. */
+    type: string;
+    /** * Denotes whether the token is suspected spam. */
+    is_spam: boolean;
+    /** * 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;
+    /** * NFT-specific data. */
+    nft_data: NftData[];
+    constructor(data: BalanceItem);
+}
+declare class NftData {
+    /** * The token's id. */
+    token_id: bigint | null;
+    token_url: string;
+    /** * The original minter. */
+    original_owner: string;
+    external_data: NftExternalData;
+    /** * If `true`, the asset data is available from the Covalent CDN. */
+    asset_cached: boolean;
+    /** * If `true`, the image data is available from the Covalent CDN. */
+    image_cached: boolean;
+    constructor(data: NftData);
+}
+declare class NftExternalData {
+    name: string;
+    description: string;
+    asset_url: string;
+    asset_file_extension: string;
+    asset_mime_type: string;
+    asset_size_bytes: string;
+    image: string;
+    image_256: string;
+    image_512: string;
+    image_1024: string;
+    animation_url: string;
+    external_url: string;
+    attributes: NftCollectionAttribute[];
+    constructor(data: NftExternalData);
+}
+declare class NftCollectionAttribute {
+    trait_type: string;
+    value: string;
+    constructor(data: NftCollectionAttribute);
+}
+declare class PortfolioResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: string;
+    /** * 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: PortfolioItem[];
+    constructor(data: PortfolioResponse);
+}
+declare class PortfolioItem {
+    /** * Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. */
+    contract_address: string;
+    /** * 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;
+    /** * The contract logo URL. */
+    logo_url: string;
+    holdings: HoldingItem[];
+    constructor(data: PortfolioItem);
+}
+declare class HoldingItem {
+    /** * The exchange rate for the requested quote currency. */
+    quote_rate: number;
+    timestamp: string;
+    close: OhlcItem;
+    high: OhlcItem;
+    low: OhlcItem;
+    open: OhlcItem;
+    constructor(data: HoldingItem);
+}
+declare class OhlcItem {
+    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
+    balance: bigint | null;
+    quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    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: string;
+    /** * 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: string;
+    /** * The height of the block. */
+    block_height: number;
+    /** * The requested transaction hash. */
+    tx_hash: string;
+    /** * The offset is the position of the tx in the block. */
+    tx_offset: number;
+    successful: boolean;
+    from_address: string;
+    from_address_label: string;
+    to_address: string;
+    to_address_label: string;
+    /** * The value attached to this tx. */
+    value: bigint | null;
+    /** * The value attached in `quote-currency` to this tx. */
+    value_quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_value_quote: string;
+    gas_offered: number;
+    gas_spent: number;
+    gas_price: number;
+    /** * The transaction's gas_price * gas_spent, denoted in wei. */
+    fees_paid: bigint | null;
+    /** * The gas spent in `quote-currency` denomination. */
+    gas_quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_gas_quote: string;
+    /** * The native gas exchange rate for the requested `quote-currency`. */
+    gas_quote_rate: number;
+    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: string;
+    /** * The requested transaction hash. */
+    tx_hash: string;
+    from_address: string;
+    from_address_label: string;
+    to_address: string;
+    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;
+    /** * 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;
+    /** * The contract logo URL. */
+    logo_url: string;
+    transfer_type: string;
+    /** * The delta attached to this transfer. */
+    delta: bigint | null;
+    /** * 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;
+    delta_quote: number;
+    /** * A prettier version of the quote for rendering purposes. */
+    pretty_delta_quote: string;
+    balance_quote: number;
+    method_calls: MethodCallsForTransfers[];
+    constructor(data: TokenTransferItem);
+}
+declare class MethodCallsForTransfers {
+    sender_address: string;
+    method: string;
+    constructor(data: MethodCallsForTransfers);
+}
+declare class TokenHoldersResponse {
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: 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: TokenHolder[];
+    /** * Pagination metadata. */
+    pagination: Pagination;
+    constructor(data: TokenHoldersResponse);
+}
+declare class TokenHolder {
+    /** * 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 requested address. */
+    address: string;
+    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
+    balance: bigint | null;
+    /** * Total supply of this token. */
+    total_supply: bigint | null;
+    /** * The height of the block. */
+    block_height: number;
+    constructor(data: TokenHolder);
+}
+declare class HistoricalBalancesResponse {
+    /** * The requested address. */
+    address: string;
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: string;
+    /** * 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: HistoricalBalanceItem[];
+    constructor(data: HistoricalBalancesResponse);
+}
+declare class HistoricalBalanceItem {
+    /** * 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 block height when the token was last transferred. */
+    last_transferred_block_height: number;
+    /** * The timestamp when the token was transferred. */
+    last_transferred_at: string;
+    /** * Indicates if a token is the chain's native gas token, eg: ETH on Ethereum. */
+    native_token: boolean;
+    /** * One of `cryptocurrency`, `stablecoin`, `nft` or `dust`. */
+    type: string;
+    /** * Denotes whether the token is suspected spam. */
+    is_spam: boolean;
+    /** * 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;
+    /** * NFT-specific data. */
+    nft_data: NftData[];
+    constructor(data: HistoricalBalanceItem);
+}
+/**
+ * Balances APIs
+ *
+ */
+export declare class Response<T> {
+    data: T;
+    error: boolean;
+    error_code: number;
+    error_message: string;
+}
+export declare class BalanceService {
+    private apiKey;
+    constructor(apiKey: string);
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     * @param {boolean} nft - If `true`, NFTs will be included in the response.
+     * @param {boolean} noNftFetch - If `true`, only NFTs that have been cached will be included in the response. Helpful for faster response times.
+     * @param {boolean} noSpam - If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`.
+     * @param {boolean} 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, quoteCurrency?: Quotes, nft?: boolean, noNftFetch?: boolean, noSpam?: boolean, noNftAssetMetadata?: boolean): Promise<Response<BalancesResponse>>;
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     * @param {number} days - The number of days to return data for. Defaults to 30 days.
+     *
+     */
+    getHistoricalPortfolioForWalletAddress(chainName: Chains, walletAddress: string, quoteCurrency?: Quotes, days?: number): Promise<Response<PortfolioResponse>>;
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     * @param {string} contractAddress - The requested contract address.
+     * @param {number} startingBlock - The block height to start from, defaults to `0`.
+     * @param {number} endingBlock - The block height to end at, defaults to current block height.
+     *
+     */
+    getErc20TransfersForWalletAddress(chainName: Chains, walletAddress: string, quoteCurrency?: Quotes, contractAddress?: string, startingBlock?: number, endingBlock?: number): Promise<Response<Erc20TransfersResponse>>;
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} tokenAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {number} blockHeight - Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     * @param {number} pageSize - Number of items per page. Note: Currently, only values of `100` and `1000` are supported. Omitting this parameter defaults to 100.
+     * @param {number} pageNumber - 0-indexed page number to begin pagination.
+     *
+     */
+    getTokenHoldersV2ForTokenAddress(chainName: Chains, tokenAddress: string, blockHeight?: number, pageSize?: number, pageNumber?: number): Promise<Response<TokenHoldersResponse>>;
+    /**
+     *
+     * @param {string} chainName - The chain name eg: `eth-mainnet`.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {string} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     * @param {boolean} nft - If `true`, NFTs will be included in the response.
+     * @param {boolean} noNftFetch - If `true`, only NFTs that have been cached will be included in the response. Helpful for faster response times.
+     * @param {boolean} noSpam - If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`.
+     * @param {boolean} 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.
+     * @param {number} blockHeight - Ending block to define a block range. Omitting this parameter defaults to the latest block height.
+     * @param {number} date - Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date.
+     *
+     */
+    getHistoricalTokenBalancesForWalletAddress(chainName: Chains, walletAddress: string, quoteCurrency?: Quotes, nft?: boolean, noNftFetch?: boolean, noSpam?: boolean, noNftAssetMetadata?: boolean, blockHeight?: number, date?: number): Promise<Response<HistoricalBalancesResponse>>;
+}
+export {};