@covalenthq/client-sdk 2.2.1 → 2.2.2

package/dist/cjs/src/GoldRushClient.d.ts

@@ -1,6 +1,7 @@
 import { AllChainsService } from "./services/AllChainsService";
 import { BalanceService } from "./services/BalanceService";
 import { BaseService } from "./services/BaseService";
+import { BitcoinService } from "./services/BitcoinService";
 import { NftService } from "./services/NftService";
 import { PricingService } from "./services/PricingService";
 import { SecurityService } from "./services/SecurityService";
@@ -14,6 +15,7 @@ export declare class GoldRushClient {
     AllChainsService: AllChainsService;
     BalanceService: BalanceService;
     BaseService: BaseService;
+    BitcoinService: BitcoinService;
     NftService: NftService;
     PricingService: PricingService;
     SecurityService: SecurityService;

package/dist/cjs/src/services/AllChainsService.d.ts

@@ -1,5 +1,5 @@
 import { type Execution } from "../utils/functions/execution";
-import { type GetMultiChainAndMultiAddressTransactionsParamOtps, type MultiChainMultiAddressTransactionsResponse } from "../utils/types/AllChainService.types";
+import { type ChainActivityResponse, type GetAddressActivityQueryParamOpts, type GetMultiChainBalanceQueryParamOpts, type GetMultiChainMultiAddressTransactionsParamOtps, type MultiChainBalanceResponse, type MultiChainMultiAddressTransactionsResponse } from "../utils/types/AllChainService.types";
 import { type GoldRushResponse } from "../utils/types/Generic.types";
 /**
  * Cross Chain API
@@ -8,6 +8,16 @@ import { type GoldRushResponse } from "../utils/types/Generic.types";
 export declare class AllChainsService {
     private execution;
     constructor(execution: Execution);
+    /**
+     *
+     * Commonly used to locate chains which an address is active on with a single API call.
+     *
+     * @param {string} walletAddress - The requested wallet address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetAddressActivityQueryParamOpts} queryParamOpts
+     *   - `testnets`: Set to true to include testnets with activity in the response. By default, it's set to `false` and only returns mainnet activity.
+     *
+     */
+    getAddressActivity(walletAddress: string, queryParamOpts?: GetAddressActivityQueryParamOpts): Promise<GoldRushResponse<ChainActivityResponse>>;
     /**
      *
      * Commonly used to get transactions cross chains and addresses.
@@ -19,8 +29,35 @@ export declare class AllChainsService {
      * @param {string} after - Pagination cursor pointing to fetch transactions after a certain point.
      * @param {boolean} withLogs - Whether to include raw logs in the response.
      * @param {boolean} withDecodedLogs - Whether to include decoded logs in the response.
-     * @param {Quote | "BTC" | "ETH"} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, "BTC" and "ETH".
+     * @param {Quote | CryptocurrencyQuote} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, `BTC` and `ETH`.
+     *
+     */
+    getMultiChainMultiAddressTransactions(queryParamOpts?: GetMultiChainMultiAddressTransactionsParamOtps): Promise<GoldRushResponse<MultiChainMultiAddressTransactionsResponse>>;
+    /**
+     * @deprecated This method is deprecated and will be removed in the upcoming versions. Please use `AllChainsService.getMultiChainMultiAddressTransactions` instead.
+     *
+     * Commonly used to get transactions cross chains and addresses.
+     *
+     * @param {Chain[]} chains - An array of the chain names or IDs to retrieve transactions from. Defaults to all foundational chains.
+     * @param {string[]} addresses - An array of addresses for which transactions are fetched. Does not support name resolution.
+     * @param {number} limit - Number of transactions to return per page, up to the default max of 100 items.
+     * @param {string} before - Pagination cursor pointing to fetch transactions before a certain point.
+     * @param {string} after - Pagination cursor pointing to fetch transactions after a certain point.
+     * @param {boolean} withLogs - Whether to include raw logs in the response.
+     * @param {boolean} withDecodedLogs - Whether to include decoded logs in the response.
+     * @param {Quote | CryptocurrencyQuote} quoteCurrency - The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, `BTC` and `ETH`.
+     *
+     */
+    getMultiChainAndMultiAddressTransactions(queryParamOpts?: GetMultiChainMultiAddressTransactionsParamOtps): Promise<GoldRushResponse<MultiChainMultiAddressTransactionsResponse>>;
+    /**
      *
+     * @param {string} walletAddress - The requested wallet Address.
+     * @param {GetMultiChainBalanceQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`,  `GBP`, `BTC`, and `ETH`.
+     *   - `chains`: Array chain ids or chain names to query. Limited to 10 chains.
+     *   - `limit`: The number of items to return. Default is 100.
+     *   - `timestamp`: The timestamp to query balances at. If omitted, the latest balances are returned.
+     *   - `cursorBefore`: The cursor of previous page.
      */
-    getMultiChainAndMultiAddressTransactions(queryParamOpts?: GetMultiChainAndMultiAddressTransactionsParamOtps): Promise<GoldRushResponse<MultiChainMultiAddressTransactionsResponse>>;
+    getMultiChainBalances(walletAddress: string, queryParamOpts?: GetMultiChainBalanceQueryParamOpts): Promise<GoldRushResponse<MultiChainBalanceResponse>>;
 }

package/dist/cjs/src/services/BaseService.d.ts

@@ -1,5 +1,6 @@
 import { type Execution } from "../utils/functions/execution";
-import { type AllChainsResponse, type AllChainsStatusResponse, type BlockHeightsResponse, type BlockResponse, type ChainActivityResponse, type GasPricesResponse, type GetAddressActivityQueryParamOpts, type GetBlockHeightsQueryParamOpts, type GetGasPricesQueryParamOpts, type GetLogEventsByAddressQueryParamOpts, type GetLogEventsByTopicHashQueryParamOpts, type GetLogsQueryParamOpts, type GetLogsResponse, type LogEventsByAddressResponse, type LogEventsByTopicHashResponse, type ResolvedAddress } from "../utils/types/BaseService.types";
+import { type ChainActivityResponse, type GetAddressActivityQueryParamOpts } from "../utils/types/AllChainService.types";
+import { type AllChainsResponse, type AllChainsStatusResponse, type BlockHeightsResponse, type BlockResponse, type GasPricesResponse, type GetBlockHeightsQueryParamOpts, type GetGasPricesQueryParamOpts, type GetLogEventsByAddressQueryParamOpts, type GetLogEventsByTopicHashQueryParamOpts, type GetLogsQueryParamOpts, type GetLogsResponse, type LogEventsByAddressResponse, type LogEventsByTopicHashResponse, type ResolvedAddress } from "../utils/types/BaseService.types";
 import { type Chain, type GoldRushResponse } from "../utils/types/Generic.types";
 /**
  * Base API
@@ -140,6 +141,7 @@ export declare class BaseService {
      */
     getAllChainStatus(): Promise<GoldRushResponse<AllChainsStatusResponse>>;
     /**
+     * @deprecated This method is deprecated and will be removed in the upcoming versions. Please use `AllChainsService.getAddressActivity` instead.
      *
      * Commonly used to locate chains which an address is active on with a single API call.
      *

package/dist/cjs/src/services/BitcoinService.d.ts

@@ -0,0 +1,40 @@
+import { type Execution } from "../utils/functions/execution";
+import { type BalancesResponse } from "../utils/types/BalanceService.types";
+import { type BitcoinHdWalletBalancesResponse, type BitcoinTransactionResponse, type GetBitcoinHdWalletBalancesQueryParamOpts, type GetBitcoinNonHdWalletBalancesQueryParamOpts, type GetTransactionsForBitcoinAddressParamOpts } from "../utils/types/BitcoinService.types";
+import { type GoldRushResponse } from "../utils/types/Generic.types";
+/**
+ * Bitcoin APIs
+ *
+ */
+export declare class BitcoinService {
+    private execution;
+    constructor(execution: Execution);
+    /**
+     *
+     * @param {string} walletAddress - The requested Bitcoin HD address.
+     * @param {GetBitcoinHdWalletBalancesQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *
+     */
+    getBitcoinHdWalletBalances(walletAddress: string, queryParamOpts?: GetBitcoinHdWalletBalancesQueryParamOpts): Promise<GoldRushResponse<BitcoinHdWalletBalancesResponse>>;
+    /**
+     *
+     * Used to fetch the full transaction history of a Bitcoin wallet.
+     *
+     * @param {GetTransactionsForBitcoinAddressParamOpts} queryParamOpts
+     *   - `address`: The bitcoin address to query.
+     *   - `pageSize`: Number of items per page. Omitting this parameter defaults to 100.
+     *   - `pageNumber`: 0-indexed page number to begin pagination.
+     */
+    getTransactionsForBtcAddress(queryParamOpts?: GetTransactionsForBitcoinAddressParamOpts): Promise<GoldRushResponse<BitcoinTransactionResponse>>;
+    /**
+     *
+     * Commonly used to fetch the tokens held by an address. Response includes spot prices and other metadata.
+     *
+     * @param {string} walletAddress - The requested Bitcoin Non HD address.
+     * @param {GetBitcoinNonHdWalletBalancesQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *
+     */
+    getBitcoinNonHdWalletBalances(walletAddress: string, queryParamOpts?: GetBitcoinNonHdWalletBalancesQueryParamOpts): Promise<GoldRushResponse<BalancesResponse>>;
+}

package/dist/cjs/src/utils/types/AllChainService.types.d.ts

@@ -1,5 +1,22 @@
-import { type Chain, type ChainID, type ChainName, type Nullable, type Quote } from "./Generic.types";
+import { type ChainItem } from "./BaseService.types";
+import { type Chain, type ChainID, type ChainName, type CryptocurrencyQuote, type LogoUrls, type Nullable, type Quote } from "./Generic.types";
 import { type Transaction } from "./TransactionService.types";
+export type ChainActivityEvent = Nullable<{
+    /** * The timestamp when the address was last seen on the chain. */
+    last_seen_at: Date;
+} & ChainItem>;
+export type ChainActivityResponse = Nullable<{
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * The requested address. */
+    address: string;
+    /** * List of response items. */
+    items: ChainActivityEvent[];
+}>;
+export type GetAddressActivityQueryParamOpts = Nullable<{
+    /** * Set to true to include testnets with activity in the response. By default, it's set to `false` and only returns mainnet activity. */
+    testnets?: boolean;
+}>;
 export type MultiChainTransaction = Transaction & {
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
@@ -14,11 +31,11 @@ export type MultiChainMultiAddressTransactionsResponse = Nullable<{
     /** * The the pagination cursor to get the next page of results */
     cursor_after: string;
     /** * The requested quote currency eg: `USD`. */
-    quote_currency: Quote | "ETH" | "BTC";
+    quote_currency: Quote | CryptocurrencyQuote;
     /** * List of response items. */
     items: MultiChainTransaction[];
 }>;
-export type GetMultiChainAndMultiAddressTransactionsParamOtps = Nullable<{
+export type GetMultiChainMultiAddressTransactionsParamOtps = Nullable<{
     /** * An array of the chain names or IDs to retrieve transactions from. Defaults to all foundational chains. */
     chains?: Chain[];
     /** * An array of addresses for which transactions are fetched. Does not support name resolution. */
@@ -34,5 +51,73 @@ export type GetMultiChainAndMultiAddressTransactionsParamOtps = Nullable<{
     /** * Whether to include decoded logs in the response. */
     withDecodedLogs?: boolean;
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, "BTC" and "ETH". */
-    quoteCurrency?: Quote | "BTC" | "ETH";
+    quoteCurrency?: Quote | CryptocurrencyQuote;
+}>;
+export type MultiChainBalanceItem = Nullable<{
+    /** * 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 requested chain ID eg: `1`. */
+    chain_id: ChainID;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: ChainName;
+}>;
+export type GetMultiChainBalanceQueryParamOpts = Nullable<{
+    /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, `GBP`, `ETH`, and `BTC`. */
+    quoteCurrency?: Quote | CryptocurrencyQuote;
+    /** * The cursor for pagination. */
+    before?: string;
+    /** * The number of items per page. Omitting this parameter defaults to 100. */
+    limit?: number;
+    /** * The requested chain ID or chain names eg: `[1,137], ["eth-mainnet", "bsc-mainnet"]`. Defaults to Foundational Chains. */
+    chains?: ChainID[] | ChainName[];
+    /** * The timestamp to query balances at. If omitted, the latest balances are returned. */
+    cutoffTimestamp?: number;
+}>;
+export type MultiChainBalanceResponse = Nullable<{
+    /** * Next cursor for pagination. */
+    cursor_before: 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: Quote | CryptocurrencyQuote;
+    /** * List of response items. */
+    items: MultiChainBalanceItem[];
 }>;

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

@@ -7,7 +7,7 @@ export type BalancesResponse = Nullable<{
     /** * The requested chain name eg: `eth-mainnet`. */
     chain_name: ChainName;
     /** * The requested quote currency eg: `USD`. */
-    quote_currency: string;
+    quote_currency: Quote;
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
     /** * List of response items. */
@@ -104,7 +104,7 @@ export type PortfolioResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -148,7 +148,7 @@ export type Erc20TransfersResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -291,7 +291,7 @@ export type HistoricalBalancesResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -344,7 +344,7 @@ export type TokenBalanceNativeResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */

package/dist/cjs/src/utils/types/BaseService.types.d.ts

@@ -1,4 +1,4 @@
-import { type ChainID, type ChainName, type DecodedItem, type LogEvent, type Nullable, type Pagination, type Quote } from "./Generic.types";
+import { type ChainID, type ChainLabel, type ChainName, type DecodedItem, type LogEvent, type Nullable, type Pagination, type Quote } from "./Generic.types";
 export type BlockResponse = Nullable<{
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
@@ -182,7 +182,7 @@ export type ChainItem = Nullable<{
     /** * The ChainItem the appchain is a part of. */
     appchain_of: ChainItem;
     /** * A classification of the chain */
-    priority_label: "Foundational" | "Frontier" | "Community";
+    priority_label: ChainLabel;
 }>;
 export type ColorTheme = Nullable<{
     /** * The red color code. */
@@ -226,25 +226,13 @@ export type ChainStatusItem = Nullable<{
     /** * True if the chain has data and ready for querying. */
     has_data: boolean;
 }>;
-export type ChainActivityResponse = Nullable<{
-    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
-    updated_at: Date;
-    /** * The requested address. */
-    address: string;
-    /** * List of response items. */
-    items: ChainActivityEvent[];
-}>;
-export type ChainActivityEvent = Nullable<{
-    /** * The timestamp when the address was last seen on the chain. */
-    last_seen_at: Date;
-} & ChainItem>;
 export type GasPricesResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
     updated_at: Date;
     /** * The requested event type. */
@@ -318,10 +306,6 @@ export type GetLogEventsByTopicHashQueryParamOpts = Nullable<{
     /** * 0-indexed page number to begin pagination. */
     pageNumber?: number;
 }>;
-export type GetAddressActivityQueryParamOpts = Nullable<{
-    /** * Set to true to include testnets with activity in the response. By default, it's set to `false` and only returns mainnet activity. */
-    testnets?: boolean;
-}>;
 export type GetGasPricesQueryParamOpts = Nullable<{
     /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
     quoteCurrency?: Quote;

package/dist/cjs/src/utils/types/BitcoinService.types.d.ts

@@ -0,0 +1,88 @@
+import { type BalanceItem } from "./BalanceService.types";
+import { type ChainID, type ChainName, type Nullable, type Pagination, type Quote } from "./Generic.types";
+export type GetBitcoinHdWalletBalancesQueryParamOpts = Nullable<{
+    /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
+    quoteCurrency?: Quote;
+}>;
+export type BitcoinHdWalletBalancesResponse = Nullable<{
+    /** * 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: Quote;
+    /** * Bitcoin chain ID. */
+    chain_id: ChainID;
+    /** * Bitcoin Chain Name. */
+    chain_name: ChainName;
+    /** * List of response items. */
+    items: BitcoinHdWalletBalanceItem[];
+}>;
+export type BitcoinHdWalletBalanceItem = BalanceItem & Nullable<{
+    /** * The specific Bitcoin address derived from the HD wallet. */
+    child_address: string;
+    /** * Derivation path used to derive the specific Bitcoin address, e.g., M/0H/0/0. */
+    address_path: string;
+    /** * The HD wallet path. */
+    hd_wallet_path: string;
+}>;
+export type GetTransactionsForBitcoinAddressParamOpts = Nullable<{
+    /** * The bitcoin address to query. */
+    address?: string;
+    /** * Omit log events. */
+    pageSize?: number;
+    /** * Include safe details. */
+    pageNumber?: number;
+}>;
+export type GetBitcoinNonHdWalletBalancesQueryParamOpts = Nullable<{
+    /** * The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. */
+    quoteCurrency?: Quote;
+}>;
+export type BitcoinTransactionResponse = Nullable<{
+    /** * The timestamp when the response was generated. Useful to show data staleness to users. */
+    updated_at: Date;
+    /** * List of response items. */
+    items: BitcoinTransaction[];
+    /** * Pagination metadata. */
+    pagination: Pagination;
+}>;
+export type BitcoinTransaction = Nullable<{
+    /** The requested chain ID eg: 20090103. */
+    chain_id: number;
+    /** The requested chain name eg: btc-mainnet. */
+    chain_name: string;
+    /** Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}. */
+    contract_decimals: number;
+    /** The block signed timestamp in UTC. */
+    block_signed_at: Date;
+    /** The height of the block. */
+    block_height: number;
+    /** The hash of the block. */
+    block_hash: string;
+    /** The requested transaction hash. */
+    tx_hash: string;
+    /** The position index of the tx in the block. */
+    tx_idx: number;
+    /** Either 'input' as the sender or 'output' as the receiver of btc. */
+    type: string;
+    /** The wallet address. */
+    address: string;
+    /** The value attached to this tx in satoshi. */
+    value: bigint;
+    /** The value attached to this tx in USD. */
+    quote: number;
+    /** The value token exchange rate in USD. */
+    quote_rate: number;
+    /** The total transaction fees denoted in satoshi. */
+    fees_paid: bigint;
+    /** The gas spent in USD. */
+    gas_quote: number;
+    /** The native gas token exchange rate in USD. */
+    gas_quote_rate: number;
+    /** Indicates if this is a coinbase tx where btc is rewarded to a miner for validating the block. */
+    coinbase: boolean;
+    /** The earliest Unix timestamp or block height at which the tx is valid and can be included. Is 0 if no restriction. */
+    locktime: number;
+    /** A measure that reflects impact on the block size limit. Used to determine fees. */
+    weight: number;
+}>;

package/dist/cjs/src/utils/types/Generic.types.d.ts

@@ -337,6 +337,8 @@ export declare enum ChainID {
 export type Chain = ChainID | ChainName | `${ChainName}` | `${ChainID}`;
 export type Source = "Ponder" | "GoldRush" | "Viem";
 export type Quote = "USD" | "CAD" | "EUR" | "SGD" | "INR" | "JPY" | "VND" | "CNY" | "KRW" | "RUB" | "TRY" | "NGN" | "ARS" | "AUD" | "CHF" | "GBP";
+export type CryptocurrencyQuote = "ETH" | "BTC";
+export type ChainLabel = "Foundational" | "Frontier" | "Community";
 export interface Pagination {
     /** * True is there is another page. */
     has_more: boolean;

package/dist/cjs/src/utils/types/SecurityService.types.d.ts

@@ -1,11 +1,11 @@
-import { type ChainID, type ChainName, type Nullable } from "./Generic.types";
+import { type ChainID, type ChainName, type Nullable, type Quote } from "./Generic.types";
 export type ApprovalsResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -89,6 +89,8 @@ export type NftApprovalsItem = Nullable<{
     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;
+    /** * A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. */
+    supports_erc: string[];
     /** * List of asset balances held by the user. */
     token_balances: NftApprovalBalance[];
     /** * Contracts with non-zero approvals for this token. */

package/dist/cjs/src/utils/types/TransactionService.types.d.ts

@@ -268,7 +268,7 @@ export type RecentTransactionsResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -290,7 +290,7 @@ export type TransactionsTimeBucketResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */
@@ -353,7 +353,7 @@ export type TransactionsResponse = Nullable<{
     /** * 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;
+    quote_currency: Quote;
     /** * The requested chain ID eg: `1`. */
     chain_id: ChainID;
     /** * The requested chain name eg: `eth-mainnet`. */

package/dist/esm/index.d.ts

@@ -4,8 +4,10 @@ export { calculatePrettyBalance } from "./src/utils/functions/calculatePrettyBal
 export { isValidApiKey } from "./src/utils/functions/isValidApiKey";
 export { prettifyCurrency } from "./src/utils/functions/prettifyCurrency";
 export { timestampParser } from "./src/utils/functions/timestamp-parser";
+export * from "./src/utils/types/AllChainService.types";
 export * from "./src/utils/types/BalanceService.types";
 export * from "./src/utils/types/BaseService.types";
+export * from "./src/utils/types/BitcoinService.types";
 export * from "./src/utils/types/Generic.types";
 export * from "./src/utils/types/NftService.types";
 export * from "./src/utils/types/PricingService.types";