@covalenthq/client-sdk 2.2.4 → 2.2.5

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

@@ -50,7 +50,7 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getErc20TransfersForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<GoldRushResponse<Erc20TransfersResponse>>;
+    getErc20TransfersForWalletAddress(chainName: Chain, walletAddress: string, queryParamOpts: GetErc20TransfersForWalletAddressQueryParamOpts): AsyncIterable<GoldRushResponse<Erc20TransfersResponse>>;
     /**
      *
      * Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address.
@@ -66,7 +66,7 @@ export declare class BalanceService {
      *   - `pageNumber`: 0-indexed page number to begin pagination.
      *
      */
-    getErc20TransfersForWalletAddressByPage(chainName: Chain, walletAddress: string, queryParamOpts?: GetErc20TransfersForWalletAddressQueryParamOpts): Promise<GoldRushResponse<Erc20TransfersResponse>>;
+    getErc20TransfersForWalletAddressByPage(chainName: Chain, walletAddress: string, queryParamOpts: GetErc20TransfersForWalletAddressQueryParamOpts): Promise<GoldRushResponse<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.

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

@@ -1,6 +1,6 @@
 import { type Execution } from "../utils/functions/execution";
-import { type Chain, type GoldRushResponse } from "../utils/types/Generic.types";
-import { type GetAllTransactionsForAddressQueryParamOpts, type GetTimeBucketTransactionsForAddressQueryParamOpts, type GetTransactionQueryParamOpts, type GetTransactionSummaryQueryParamOpts, type GetTransactionsForAddressV3QueryParamOpts, type GetTransactionsForBlockQueryParamOpts, type RecentTransactionsResponse, type TransactionResponse, type TransactionsBlockResponse, type TransactionsResponse, type TransactionsSummaryResponse, type TransactionsTimeBucketResponse } from "../utils/types/TransactionService.types";
+import type { Chain, GoldRushResponse } from "../utils/types/Generic.types";
+import type { EarliestTransactionsForAddressResponse, GetAllTransactionsForAddressQueryParamOpts, GetEarliestTransactionsForAddressQueryParamOpts, getPaginatedTransactionsForAddressQueryParamOpts, GetTimeBucketTransactionsForAddressQueryParamOpts, GetTransactionQueryParamOpts, getTransactionsForBlockByPageQueryParamOpts, GetTransactionSummaryQueryParamOpts, RecentTransactionsResponse, TransactionResponse, TransactionsBlockResponse, TransactionsForBlockResponse, TransactionsResponse, TransactionsSummaryResponse, TransactionsTimeBucketResponse } from "../utils/types/TransactionService.types";
 /**
  * Transactions API
  *
@@ -23,6 +23,30 @@ export declare class TransactionService {
      *
      */
     getTransaction(chainName: Chain, txHash: string, queryParamOpts?: GetTransactionQueryParamOpts): Promise<GoldRushResponse<TransactionResponse>>;
+    /**
+     *
+     * Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.
+     *
+     * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetTransactionSummaryQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `withGas`: Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions.
+     *
+     */
+    getTransactionSummary(chainName: Chain, walletAddress: string, queryParamOpts?: GetTransactionSummaryQueryParamOpts): Promise<GoldRushResponse<TransactionsSummaryResponse>>;
+    /**
+     *
+     * Commonly used to fetch and render the earliest transactions involving an address. Frequently seen in wallet applications.
+     *
+     * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetEarliestTransactionsForAddressQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `noLogs`: Omit log events.
+     *
+     */
+    getEarliestTransactionsForAddress(chainName: Chain, walletAddress: string, queryParamOpts?: GetEarliestTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<EarliestTransactionsForAddressResponse>>;
     /**
      *
      * Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.
@@ -56,50 +80,55 @@ export declare class TransactionService {
      */
     getAllTransactionsForAddressByPage(chainName: Chain, walletAddress: string, queryParamOpts?: GetAllTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<RecentTransactionsResponse>>;
     /**
-     *
-     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {number} blockHeight - The requested block height.
-     * @param {GetTransactionsForBlockQueryParamOpts} queryParamOpts
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {number} page - The requested page, 0-indexed.
+     * @param {getPaginatedTransactionsForAddressQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
+     *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
      *
      */
-    getTransactionsForBlock(chainName: Chain, blockHeight: number | string | "latest", queryParamOpts?: GetTransactionsForBlockQueryParamOpts): Promise<GoldRushResponse<TransactionsBlockResponse>>;
+    getPaginatedTransactionsForAddress(chainName: Chain, walletAddress: string, page: number, queryParamOpts?: getPaginatedTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<TransactionsResponse>>;
     /**
-     *
-     * Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
      * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {GetTransactionSummaryQueryParamOpts} queryParamOpts
+     * @param {number} timeBucket - The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.
+     * @param {GetTimeBucketTransactionsForAddressQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
-     *   - `withGas`: Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions.
+     *   - `noLogs`: Omit log events.
      *
      */
-    getTransactionSummary(chainName: Chain, walletAddress: string, queryParamOpts?: GetTransactionSummaryQueryParamOpts): Promise<GoldRushResponse<TransactionsSummaryResponse>>;
+    getTimeBucketTransactionsForAddress(chainName: Chain, walletAddress: string, timeBucket: number, queryParamOpts?: GetTimeBucketTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<TransactionsTimeBucketResponse>>;
     /**
+     *
+     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {number} blockHeight - The requested block height.
      * @param {number} page - The requested page, 0-indexed.
-     * @param {GetTransactionsForAddressV3QueryParamOpts} queryParamOpts
+     * @param {getTransactionsForBlockByPageQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
-     *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
      *
      */
-    getTransactionsForAddressV3(chainName: Chain, walletAddress: string, page: number, queryParamOpts?: GetTransactionsForAddressV3QueryParamOpts): Promise<GoldRushResponse<TransactionsResponse>>;
+    getTransactionsForBlockByPage(chainName: Chain, blockHeight: number | string | "latest", page: number, queryParamOpts?: getTransactionsForBlockByPageQueryParamOpts): Promise<GoldRushResponse<TransactionsBlockResponse>>;
     /**
+     *
+     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {number} timeBucket - The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.
-     * @param {GetTimeBucketTransactionsForAddressQueryParamOpts} queryParamOpts
+     * @param {string} blockHash - The requested block hash.
+     * @param {getTransactionsForBlockByPageQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
      *
      */
-    getTimeBucketTransactionsForAddress(chainName: Chain, walletAddress: string, timeBucket: number, queryParamOpts?: GetTimeBucketTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<TransactionsTimeBucketResponse>>;
+    getTransactionsForBlock(chainName: Chain, blockHash: string, queryParamOpts?: getTransactionsForBlockByPageQueryParamOpts): Promise<GoldRushResponse<TransactionsForBlockResponse>>;
+    /**
+     * @deprecated This method has been deprecated and will be removed in future releases. Use `getPaginatedTransactionsForAddress` instead.
+     */
+    getTransactionsForAddressV3(chainName: Chain, walletAddress: string, page: number, queryParamOpts?: getPaginatedTransactionsForAddressQueryParamOpts): Promise<GoldRushResponse<TransactionsResponse>>;
 }

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

@@ -398,7 +398,7 @@ export type GetErc20TransfersForWalletAddressQueryParamOpts = 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;
     /** * The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. */
-    contractAddress?: string;
+    contractAddress: string;
     /** * The block height to start from, defaults to `0`. */
     startingBlock?: number;
     /** * The block height to end at, defaults to current block height. */

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

@@ -172,6 +172,12 @@ export type TransactionsBlockResponse = Nullable<{
     chain_name: ChainName;
     /** * List of response items. */
     items: Transaction[];
+    /** * URL link to the next and prev pages. */
+    links: PaginationLinks;
+    /** * An executable async function for the next page. */
+    next: (() => Promise<GoldRushResponse<TransactionsBlockResponse>>) | null;
+    /** * An executable async function for the prev page. */
+    prev: (() => Promise<GoldRushResponse<TransactionsBlockResponse>>) | null;
 }>;
 export type TransactionsSummaryResponse = Nullable<{
     /** * The timestamp when the response was generated. Useful to show data staleness to users. */
@@ -283,13 +289,13 @@ export type GetAllTransactionsForAddressQueryParamOpts = Nullable<{
     /** * Whether to include the transaction's input data such as the Method ID. */
     withInputData?: boolean;
 }>;
-export type GetTransactionsForBlockQueryParamOpts = Nullable<{
+export type getTransactionsForBlockByPageQueryParamOpts = 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;
     /** * Omit log events. */
     noLogs?: boolean;
 }>;
-export type GetTransactionsForAddressV3QueryParamOpts = Nullable<{
+export type getPaginatedTransactionsForAddressQueryParamOpts = 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;
     /** * Omit log events. */
@@ -345,3 +351,42 @@ export type InputData = Nullable<{
     /** * The first 4 bytes of the invoked smart contract function signature. Used to identify the function being called in the contract. */
     method_id: string;
 }>;
+export type GetEarliestTransactionsForAddressQueryParamOpts = 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;
+    /** * Omit log events. */
+    noLogs?: boolean;
+}>;
+export type EarliestTransactionsForAddressResponse = 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;
+    /** * The requested chain ID eg: `1`. */
+    chain_id: ChainID;
+    /** * The requested chain name eg: `eth-mainnet`. */
+    chain_name: ChainName;
+    complete: boolean;
+    /** * The current bucket of the response. */
+    current_bucket: number;
+    /** * URL link to the next and prev pages. */
+    links: PaginationLinks;
+    /** * List of response items. */
+    items: Transaction[];
+    /** * An executable async function for the prev page. */
+    prev: (() => Promise<GoldRushResponse<EarliestTransactionsForAddressResponse>>) | null;
+    /** * An executable async function for the next page. */
+    next: (() => Promise<GoldRushResponse<EarliestTransactionsForAddressResponse>>) | null;
+}>;
+export type TransactionsForBlockResponse = Nullable<{
+    /** * 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: Transaction[];
+}>;

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-var version = "2.2.4";
+var version = "2.2.5";
 
 const bigIntParser = (val) => {
     if (val === null || val === undefined) {
@@ -2452,6 +2452,119 @@ class TransactionService {
         };
         return await this.execution.execute(endpoint, parseData);
     }
+    /**
+     *
+     * Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.
+     *
+     * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetTransactionSummaryQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `withGas`: Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions.
+     *
+     */
+    async getTransactionSummary(chainName, walletAddress, queryParamOpts) {
+        const endpoint = endpointGenerator(`${chainName}/address/${walletAddress}/transactions_summary`, [
+            {
+                key: "quote-currency",
+                value: queryParamOpts?.quoteCurrency,
+            },
+            {
+                key: "with-gas",
+                value: queryParamOpts?.withGas,
+            },
+        ]);
+        const parseData = (data) => {
+            if (data.data) {
+                data.data.updated_at = data.data.updated_at
+                    ? new Date(data.data.updated_at)
+                    : null;
+                data.data.items = data.data.items
+                    ? data.data.items.map((txsItem) => ({
+                        ...txsItem,
+                        earliest_transaction: {
+                            ...txsItem.earliest_transaction,
+                            block_signed_at: txsItem?.earliest_transaction?.block_signed_at
+                                ? new Date(txsItem.earliest_transaction.block_signed_at)
+                                : null,
+                        },
+                        latest_transaction: {
+                            ...txsItem.latest_transaction,
+                            block_signed_at: txsItem?.latest_transaction?.block_signed_at
+                                ? new Date(txsItem?.latest_transaction?.block_signed_at)
+                                : null,
+                        },
+                        // ? API vs docs non-consistent
+                        // gas_summary: {
+                        //   ...txsItem.gas_summary,
+                        //   total_fees_paid: bigIntParser(
+                        //     txsItem.gas_summary.total_fees_paid
+                        //   ),
+                        // },
+                    }))
+                    : null;
+            }
+            return data;
+        };
+        return await this.execution.execute(endpoint, parseData);
+    }
+    /**
+     *
+     * Commonly used to fetch and render the earliest transactions involving an address. Frequently seen in wallet applications.
+     *
+     * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {GetEarliestTransactionsForAddressQueryParamOpts} queryParamOpts
+     *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
+     *   - `noLogs`: Omit log events.
+     *
+     */
+    async getEarliestTransactionsForAddress(chainName, walletAddress, queryParamOpts) {
+        const searchParams = [
+            {
+                key: "quote-currency",
+                value: queryParamOpts?.quoteCurrency,
+            },
+            {
+                key: "no-logs",
+                value: queryParamOpts?.noLogs,
+            },
+        ];
+        const endpoint = endpointGenerator(`${chainName}/bulk/transactions/${walletAddress}`, searchParams);
+        const parseData = (data) => {
+            if (data.data) {
+                data.data.prev = data.data?.links?.prev
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.prev, searchParams), parseData)
+                    : null;
+                data.data.next = data.data?.links?.next
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.next, searchParams), parseData)
+                    : null;
+                data.data.updated_at = data.data.updated_at
+                    ? new Date(data.data.updated_at)
+                    : null;
+                data.data.items = data.data.items
+                    ? data.data.items.map((txItem) => ({
+                        ...txItem,
+                        value: bigIntParser(txItem.value),
+                        fees_paid: bigIntParser(txItem.fees_paid),
+                        block_signed_at: txItem.block_signed_at
+                            ? new Date(txItem.block_signed_at)
+                            : null,
+                        log_events: txItem.log_events
+                            ? txItem.log_events.map((logItem) => ({
+                                ...logItem,
+                                block_signed_at: logItem.block_signed_at
+                                    ? new Date(logItem.block_signed_at)
+                                    : null,
+                            }))
+                            : null,
+                    }))
+                    : null;
+            }
+            return data;
+        };
+        return await this.execution.execute(endpoint, parseData);
+    }
     /**
      *
      * Commonly used to fetch and render the most recent transactions involving an address. Frequently seen in wallet applications.
@@ -2602,18 +2715,18 @@ class TransactionService {
         return await this.execution.execute(endpoint, parseData);
     }
     /**
-     *
-     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {number} blockHeight - The requested block height.
-     * @param {GetTransactionsForBlockQueryParamOpts} queryParamOpts
+     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {number} page - The requested page, 0-indexed.
+     * @param {getPaginatedTransactionsForAddressQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
+     *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
      *
      */
-    async getTransactionsForBlock(chainName, blockHeight, queryParamOpts) {
-        const endpoint = endpointGenerator(`${chainName}/block/${blockHeight}/transactions_v3`, [
+    async getPaginatedTransactionsForAddress(chainName, walletAddress, page, queryParamOpts) {
+        const searchParams = [
             {
                 key: "quote-currency",
                 value: queryParamOpts?.quoteCurrency,
@@ -2622,9 +2735,20 @@ class TransactionService {
                 key: "no-logs",
                 value: queryParamOpts?.noLogs,
             },
-        ]);
+            {
+                key: "block-signed-at-asc",
+                value: queryParamOpts?.blockSignedAtAsc,
+            },
+        ];
+        const endpoint = endpointGenerator(`${chainName}/address/${walletAddress}/transactions_v3/page/${page}`, searchParams);
         const parseData = (data) => {
             if (data.data) {
+                data.data.prev = data.data?.links?.prev
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.prev, searchParams), parseData)
+                    : null;
+                data.data.next = data.data?.links?.next
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.next, searchParams), parseData)
+                    : null;
                 data.data.updated_at = data.data.updated_at
                     ? new Date(data.data.updated_at)
                     : null;
@@ -2652,54 +2776,54 @@ class TransactionService {
         return await this.execution.execute(endpoint, parseData);
     }
     /**
-     *
-     * Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. Calculate the age of the wallet and the time it has been idle and quickly gain insights into their engagement with web3.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
      * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {GetTransactionSummaryQueryParamOpts} queryParamOpts
+     * @param {number} timeBucket - The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.
+     * @param {GetTimeBucketTransactionsForAddressQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
-     *   - `withGas`: Include gas summary details. Additional charge of 1 credit when true. Response times may be impacted for wallets with millions of transactions.
+     *   - `noLogs`: Omit log events.
      *
      */
-    async getTransactionSummary(chainName, walletAddress, queryParamOpts) {
-        const endpoint = endpointGenerator(`${chainName}/address/${walletAddress}/transactions_summary`, [
+    async getTimeBucketTransactionsForAddress(chainName, walletAddress, timeBucket, queryParamOpts) {
+        const searchParams = [
             {
                 key: "quote-currency",
                 value: queryParamOpts?.quoteCurrency,
             },
             {
-                key: "with-gas",
-                value: queryParamOpts?.withGas,
+                key: "no-logs",
+                value: queryParamOpts?.noLogs,
             },
-        ]);
+        ];
+        const endpoint = endpointGenerator(`${chainName}/bulk/transactions/${walletAddress}/${timeBucket}`, searchParams);
         const parseData = (data) => {
             if (data.data) {
+                data.data.prev = data.data?.links?.prev
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.prev, searchParams), parseData)
+                    : null;
+                data.data.next = data.data?.links?.next
+                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.next, searchParams), parseData)
+                    : null;
                 data.data.updated_at = data.data.updated_at
                     ? new Date(data.data.updated_at)
                     : null;
                 data.data.items = data.data.items
-                    ? data.data.items.map((txsItem) => ({
-                        ...txsItem,
-                        earliest_transaction: {
-                            ...txsItem.earliest_transaction,
-                            block_signed_at: txsItem?.earliest_transaction?.block_signed_at
-                                ? new Date(txsItem.earliest_transaction.block_signed_at)
-                                : null,
-                        },
-                        latest_transaction: {
-                            ...txsItem.latest_transaction,
-                            block_signed_at: txsItem?.latest_transaction?.block_signed_at
-                                ? new Date(txsItem?.latest_transaction?.block_signed_at)
-                                : null,
-                        },
-                        // ? API vs docs non-consistent
-                        // gas_summary: {
-                        //   ...txsItem.gas_summary,
-                        //   total_fees_paid: bigIntParser(
-                        //     txsItem.gas_summary.total_fees_paid
-                        //   ),
-                        // },
+                    ? data.data.items.map((txItem) => ({
+                        ...txItem,
+                        value: bigIntParser(txItem.value),
+                        fees_paid: bigIntParser(txItem.fees_paid),
+                        block_signed_at: txItem.block_signed_at
+                            ? new Date(txItem.block_signed_at)
+                            : null,
+                        log_events: txItem.log_events
+                            ? txItem.log_events.map((logItem) => ({
+                                ...logItem,
+                                block_signed_at: logItem.block_signed_at
+                                    ? new Date(logItem.block_signed_at)
+                                    : null,
+                            }))
+                            : null,
                     }))
                     : null;
             }
@@ -2708,17 +2832,18 @@ class TransactionService {
         return await this.execution.execute(endpoint, parseData);
     }
     /**
+     *
+     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
+     * @param {number} blockHeight - The requested block height.
      * @param {number} page - The requested page, 0-indexed.
-     * @param {GetTransactionsForAddressV3QueryParamOpts} queryParamOpts
+     * @param {getTransactionsForBlockByPageQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
-     *   - `blockSignedAtAsc`: Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order.
      *
      */
-    async getTransactionsForAddressV3(chainName, walletAddress, page, queryParamOpts) {
+    async getTransactionsForBlockByPage(chainName, blockHeight, page, queryParamOpts) {
         const searchParams = [
             {
                 key: "quote-currency",
@@ -2728,23 +2853,19 @@ class TransactionService {
                 key: "no-logs",
                 value: queryParamOpts?.noLogs,
             },
-            {
-                key: "block-signed-at-asc",
-                value: queryParamOpts?.blockSignedAtAsc,
-            },
         ];
-        const endpoint = endpointGenerator(`${chainName}/address/${walletAddress}/transactions_v3/page/${page}`, searchParams);
+        const endpoint = endpointGenerator(`${chainName}/block/${blockHeight}/transactions_v3/page/${page}`, searchParams);
         const parseData = (data) => {
             if (data.data) {
+                data.data.updated_at = data.data.updated_at
+                    ? new Date(data.data.updated_at)
+                    : null;
                 data.data.prev = data.data?.links?.prev
                     ? async () => this.execution.execute(endpointGenerator(data.data?.links?.prev, searchParams), parseData)
                     : null;
                 data.data.next = data.data?.links?.next
                     ? async () => this.execution.execute(endpointGenerator(data.data?.links?.next, searchParams), parseData)
                     : null;
-                data.data.updated_at = data.data.updated_at
-                    ? new Date(data.data.updated_at)
-                    : null;
                 data.data.items = data.data.items
                     ? data.data.items.map((txItem) => ({
                         ...txItem,
@@ -2769,16 +2890,17 @@ class TransactionService {
         return await this.execution.execute(endpoint, parseData);
     }
     /**
+     *
+     * Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions.
      *
      * @param {Chain} chainName - The chain name eg: `eth-mainnet` or 1.
-     * @param {string} walletAddress - The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically.
-     * @param {number} timeBucket - The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket.
-     * @param {GetTimeBucketTransactionsForAddressQueryParamOpts} queryParamOpts
+     * @param {string} blockHash - The requested block hash.
+     * @param {getTransactionsForBlockByPageQueryParamOpts} queryParamOpts
      *   - `quoteCurrency`: The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`.
      *   - `noLogs`: Omit log events.
      *
      */
-    async getTimeBucketTransactionsForAddress(chainName, walletAddress, timeBucket, queryParamOpts) {
+    async getTransactionsForBlock(chainName, blockHash, queryParamOpts) {
         const searchParams = [
             {
                 key: "quote-currency",
@@ -2789,15 +2911,9 @@ class TransactionService {
                 value: queryParamOpts?.noLogs,
             },
         ];
-        const endpoint = endpointGenerator(`${chainName}/bulk/transactions/${walletAddress}/${timeBucket}`, searchParams);
+        const endpoint = endpointGenerator(`${chainName}/block_hash/${blockHash}/transactions_v3`, searchParams);
         const parseData = (data) => {
             if (data.data) {
-                data.data.prev = data.data?.links?.prev
-                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.prev, searchParams), parseData)
-                    : null;
-                data.data.next = data.data?.links?.next
-                    ? async () => this.execution.execute(endpointGenerator(data.data?.links?.next, searchParams), parseData)
-                    : null;
                 data.data.updated_at = data.data.updated_at
                     ? new Date(data.data.updated_at)
                     : null;
@@ -2824,6 +2940,12 @@ class TransactionService {
         };
         return await this.execution.execute(endpoint, parseData);
     }
+    /**
+     * @deprecated This method has been deprecated and will be removed in future releases. Use `getPaginatedTransactionsForAddress` instead.
+     */
+    async getTransactionsForAddressV3(chainName, walletAddress, page, queryParamOpts) {
+        return this.getPaginatedTransactionsForAddress(chainName, walletAddress, page, queryParamOpts);
+    }
 }
 
 async function debugOutput(settings, ...content) {