@covalenthq/client-sdk 2.0.1 → 2.0.3

package/dist/es/src/utils/functions/calculatePrettyBalance.d.ts

@@ -1 +0,0 @@
-export declare const calculatePrettyBalance: (value: number | bigint, decimals?: number, roundOff?: boolean, precision?: number) => string;

package/dist/es/src/utils/functions/debugOutput.d.ts

@@ -1,2 +0,0 @@
-import { type GoldRushClientSettings } from "../types/Generic.types";
-export declare function debugOutput(settings: GoldRushClientSettings, ...content: unknown[]): Promise<void>;

package/dist/es/src/utils/functions/endpointGenerator.d.ts

@@ -1,4 +0,0 @@
-export declare const endpointGenerator: (extension?: string, params?: {
-    key: string;
-    value: boolean | null | string | number | undefined;
-}[]) => URL;

package/dist/es/src/utils/functions/execution.d.ts

@@ -1,11 +0,0 @@
-import { type GoldRushClientSettings, type GoldRushResponse } from "../types/Generic.types";
-export declare class Execution {
-    private settings;
-    private headers;
-    private maxRetries;
-    private retryDelay;
-    private enableRetry;
-    private processes;
-    constructor(settings: GoldRushClientSettings, headers: Record<string, string>);
-    execute<T>(endpoint: URL, parseData: (data: GoldRushResponse<T>) => GoldRushResponse<T>): Promise<GoldRushResponse<T>>;
-}

package/dist/es/src/utils/functions/isValidApiKey.d.ts

@@ -1 +0,0 @@
-export declare const isValidApiKey: (apiKey: string) => boolean;

package/dist/es/src/utils/functions/paginateEndpoint.d.ts

@@ -1,7 +0,0 @@
-import { type GoldRushResponse, type Pagination, type PaginationLinks } from "../types/Generic.types";
-import { type Execution } from "./execution";
-export declare function paginateEndpoint<T extends {
-    pagination: Pagination;
-} | {
-    links: PaginationLinks;
-}>(endpoint: URL, execution: Execution, parseData: (data: GoldRushResponse<T>) => GoldRushResponse<T>, implementation: "pagination" | "links"): AsyncIterable<GoldRushResponse<T>>;

package/dist/es/src/utils/functions/prettifyCurrency.d.ts

@@ -1,2 +0,0 @@
-import { type Quote } from "../types/Generic.types";
-export declare const prettifyCurrency: (value: number | bigint | string, decimals?: number, currency?: Quote, ignoreSmallValue?: boolean, ignoreMinus?: boolean, ignoreZero?: boolean) => string;

package/dist/es/src/utils/types/BalanceService.types.d.ts

@@ -1,442 +0,0 @@
-import { type ChainID, type ChainName, type ContractMetadata, type Explorer, type LogoUrls, type NftCollectionAttribute, type Pagination, type Quote } from "./Generic.types";
-export interface BalancesResponse {
-    /** * The requested address. */
-    address: string;
-    /** * The requested chain ID eg: `1`. */
-    chain_id: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * 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: Date;
-    /** * List of response items. */
-    items: BalanceItem[];
-}
-export interface 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 display-friendly name for the contract. */
-    contract_display_name: string;
-    /** * A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. */
-    supports_erc: string[];
-    /** * The contract logo URL. */
-    logo_url: string;
-    /** * The contract logo URLs. */
-    logo_urls: LogoUrls;
-    /** * The timestamp when the token was transferred. */
-    last_transferred_at: Date;
-    /** * 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;
-    /** * The 24h asset balance. Use `contract_decimals` to scale this balance for display purposes. */
-    balance_24h: bigint;
-    /** * 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;
-    /** * The protocol metadata. */
-    protocol_metadata: ProtocolMetadata;
-    /** * NFT-specific data. */
-    nft_data: BalanceNftData[];
-}
-export interface ProtocolMetadata {
-    /** * The name of the protocol. */
-    protocol_name: string;
-}
-export interface BalanceNftData {
-    /** * The token's id. */
-    token_id: bigint;
-    /** * The count of the number of NFTs with this ID. */
-    token_balance: bigint;
-    /** * External URL for additional metadata. */
-    token_url: string;
-    /** * A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. */
-    supports_erc: string[];
-    /** * The latest price value on chain of the token ID. */
-    token_price_wei: bigint;
-    /** * The latest quote_rate of the token ID denominated in unscaled ETH. */
-    token_quote_rate_eth: string;
-    /** * The address of the original owner of this NFT. */
-    original_owner: string;
-    external_data: NftExternalDataV1;
-    /** * The current owner of this NFT. */
-    owner: string;
-    /** * The address of the current owner of this NFT. */
-    owner_address: string;
-    /** * When set to true, this NFT has been Burned. */
-    burned: boolean;
-}
-export interface NftExternalDataV1 {
-    name: string;
-    description: string;
-    image: string;
-    image_256: string;
-    image_512: string;
-    image_1024: string;
-    animation_url: string;
-    external_url: string;
-    attributes: NftCollectionAttribute[];
-    owner: string;
-}
-export interface PortfolioResponse {
-    /** * 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: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * List of response items. */
-    items: PortfolioItem[];
-}
-export interface 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[];
-}
-export interface HoldingItem {
-    /** * The exchange rate for the requested quote currency. */
-    quote_rate: number;
-    timestamp: Date;
-    close: OhlcItem;
-    high: OhlcItem;
-    low: OhlcItem;
-    open: OhlcItem;
-}
-export interface OhlcItem {
-    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
-    balance: bigint;
-    /** * The current balance converted to fiat in `quote-currency`. */
-    quote: number;
-    /** * A prettier version of the quote for rendering purposes. */
-    pretty_quote: string;
-}
-export interface 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: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * List of response items. */
-    items: BlockTransactionWithContractTransfers[];
-    /** * Pagination metadata. */
-    pagination: Pagination;
-}
-export interface BlockTransactionWithContractTransfers {
-    /** * The block signed timestamp in UTC. */
-    block_signed_at: Date;
-    /** * The height of the block. */
-    block_height: number;
-    /** * The hash of the block. Use it to remove transactions from re-org-ed blocks. */
-    block_hash: string;
-    /** * The requested transaction hash. */
-    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 address of the miner. */
-    miner_address: 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;
-    /** * The value attached to this tx. */
-    value: bigint;
-    /** * 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;
-    /** * The requested chain native gas token metadata. */
-    gas_metadata: ContractMetadata;
-    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;
-    /** * 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[];
-}
-export interface TokenTransferItem {
-    /** * The block signed timestamp in UTC. */
-    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;
-    /** * 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;
-    /** * 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;
-    /** * The asset balance. Use `contract_decimals` to scale this balance for display purposes. */
-    balance: bigint;
-    /** * 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[];
-    /** * The explorer links for this transaction. */
-    explorers: Explorer[];
-}
-export interface MethodCallsForTransfers {
-    /** * The address of the sender. */
-    sender_address: string;
-    method: string;
-}
-export interface TokenHoldersResponse {
-    /** * 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: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * List of response items. */
-    items: TokenHolder[];
-    /** * Pagination metadata. */
-    pagination: Pagination;
-}
-export interface 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;
-    /** * Total supply of this token. */
-    total_supply: bigint;
-    /** * The height of the block. */
-    block_height: number;
-}
-export interface HistoricalBalancesResponse {
-    /** * 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: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * List of response items. */
-    items: HistoricalBalanceItem[];
-}
-export interface 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;
-    contract_display_name: string;
-    /** * The timestamp when the token was transferred. */
-    last_transferred_at: Date;
-    /** * 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;
-    /** * 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;
-    /** * The protocol metadata. */
-    protocol_metadata: ProtocolMetadata;
-    /** * NFT-specific data. */
-    nft_data: BalanceNftData[];
-}
-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: ChainID;
-    /** * The requested chain name eg: `eth-mainnet`. */
-    chain_name: ChainName;
-    /** * 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;
-    /** * 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;
-}
-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;
-    /** * 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. */
-    noNftFetch?: boolean;
-    /** * If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`. */
-    noSpam?: boolean;
-    /** * 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. */
-    noNftAssetMetadata?: boolean;
-}
-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?: 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?: 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`. */
-    startingBlock?: number;
-    /** * The block height to end at, defaults to current block height. */
-    endingBlock?: number;
-    /** * Number of items per page. Omitting this parameter defaults to 100. */
-    pageSize?: number;
-    /** * 0-indexed page number to begin pagination. */
-    pageNumber?: number;
-}
-export interface GetTokenHoldersV2ForTokenAddressQueryParamOpts {
-    /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
-    blockHeight?: number | string;
-    /** * Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. */
-    date?: string;
-    /** * Number of items per page. Note: Currently, only values of `100` and `1000` are supported. Omitting this parameter defaults to 100. */
-    pageSize?: number;
-    /** * 0-indexed page number to begin pagination. */
-    pageNumber?: number;
-}
-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?: 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. */
-    noNftFetch?: boolean;
-    /** * If `true`, the suspected spam tokens are removed. Supports `eth-mainnet` and `matic-mainnet`. */
-    noSpam?: boolean;
-    /** * 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. */
-    noNftAssetMetadata?: boolean;
-    /** * Ending block to define a block range. Omitting this parameter defaults to the latest block height. */
-    blockHeight?: number | string;
-    /** * Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. */
-    date?: string;
-}
-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 | string;
-}