feat: userTransactionHistory action and useUserTransactionHistory hook

Author: cesarenaldi

packages/client/src/actions/user.ts

@@ -1,10 +1,12 @@
 import {
   type MarketUserReserveBorrowPosition,
   type MarketUserReserveSupplyPosition,
+  type PaginatedUserTransactionHistoryResult,
   UserBorrowsQuery,
   type UserBorrowsRequest,
   UserSuppliesQuery,
   type UserSuppliesRequest,
+  UserTransactionHistoryQuery,
 } from '@aave/graphql';
 import type { ResultAsync } from '@aave/types';
 import type { AaveClient } from '../client';
@@ -51,3 +53,19 @@ export function userBorrows(
 ): ResultAsync<MarketUserReserveBorrowPosition[], UnexpectedError> {
   return client.query(UserBorrowsQuery, { request });
 }
+
+/**
+ * Fetches the user's transaction history.
+ *
+ * ```ts
+ * const result = await userTransactionHistory(client);
+ * ```
+ *
+ * @param client - Aave client.
+ * @returns The user's paginated transaction history.
+ */
+export function userTransactionHistory(
+  client: AaveClient,
+): ResultAsync<PaginatedUserTransactionHistoryResult, UnexpectedError> {
+  return client.query(UserTransactionHistoryQuery, {});
+}

packages/graphql/src/user.ts

@@ -1,6 +1,7 @@
 import {
   MarketUserReserveBorrowPositionFragment,
   MarketUserReserveSupplyPositionFragment,
+  PaginatedUserTransactionHistoryResultFragment,
 } from './fragments';
 import { graphql, type RequestOf } from './graphql';
 
@@ -12,7 +13,6 @@ export const UserSuppliesQuery = graphql(
   }`,
   [MarketUserReserveSupplyPositionFragment],
 );
-export type UserSuppliesRequest = RequestOf<typeof UserSuppliesQuery>;
 
 export const UserBorrowsQuery = graphql(
   `query UserBorrows($request: UserBorrowsRequest!) {
@@ -23,3 +23,14 @@ export const UserBorrowsQuery = graphql(
   [MarketUserReserveBorrowPositionFragment],
 );
 export type UserBorrowsRequest = RequestOf<typeof UserBorrowsQuery>;
+
+export const UserTransactionHistoryQuery = graphql(
+  `query UserTransactionHistory {
+    value: userTransactionHistory {
+      ...PaginatedUserTransactionHistoryResult
+    }
+  }`,
+  [PaginatedUserTransactionHistoryResultFragment],
+);
+
+export type UserSuppliesRequest = RequestOf<typeof UserSuppliesQuery>;

packages/react/src/user.ts

@@ -2,6 +2,7 @@ import type {
   MarketUserReserveBorrowPosition,
   MarketUserReserveSupplyPosition,
   MarketUserState,
+  PaginatedUserTransactionHistoryResult,
   UserBorrowsRequest,
   UserMarketStateRequest,
   UserSuppliesRequest,
@@ -10,6 +11,7 @@ import {
   UserBorrowsQuery,
   UserMarketStateQuery,
   UserSuppliesQuery,
+  UserTransactionHistoryQuery,
 } from '@aave/graphql';
 import type {
   ReadResult,
@@ -175,3 +177,39 @@ export function useUserMarketState({
     suspense,
   });
 }
+
+/**
+ * Fetch user transaction history.
+ *
+ * This signature supports React Suspense:
+ *
+ * ```tsx
+ * const { data } = useUserTransactionHistory({
+ *   suspense: true,
+ * });
+ * ```
+ */
+export function useUserTransactionHistory(
+  args: Suspendable,
+): SuspenseResult<PaginatedUserTransactionHistoryResult>;
+
+/**
+ * Fetch user transaction history.
+ *
+ * ```tsx
+ * const { data, loading } = useUserTransactionHistory();
+ * ```
+ */
+export function useUserTransactionHistory(): ReadResult<PaginatedUserTransactionHistoryResult>;
+
+export function useUserTransactionHistory({
+  suspense = false,
+}: {
+  suspense?: boolean;
+} = {}): SuspendableResult<PaginatedUserTransactionHistoryResult> {
+  return useSuspendableQuery({
+    document: UserTransactionHistoryQuery,
+    variables: {},
+    suspense,
+  });
+}