fix: build and user transaction history API

Author: cesarenaldi

packages/client/src/actions/user.ts

@@ -7,6 +7,7 @@ import {
   UserSuppliesQuery,
   type UserSuppliesRequest,
   UserTransactionHistoryQuery,
+  type UserTransactionHistoryRequest,
 } from '@aave/graphql';
 import type { ResultAsync } from '@aave/types';
 import type { AaveClient } from '../client';
@@ -66,6 +67,7 @@ export function userBorrows(
  */
 export function userTransactionHistory(
   client: AaveClient,
+  request: UserTransactionHistoryRequest,
 ): ResultAsync<PaginatedUserTransactionHistoryResult, UnexpectedError> {
-  return client.query(UserTransactionHistoryQuery, {});
+  return client.query(UserTransactionHistoryQuery, { request });
 }

packages/graphql/src/user.ts

@@ -13,6 +13,7 @@ export const UserSuppliesQuery = graphql(
   }`,
   [MarketUserReserveSupplyPositionFragment],
 );
+export type UserSuppliesRequest = RequestOf<typeof UserSuppliesQuery>;
 
 export const UserBorrowsQuery = graphql(
   `query UserBorrows($request: UserBorrowsRequest!) {
@@ -32,4 +33,6 @@ export const UserTransactionHistoryQuery = graphql(
   }`,
   [PaginatedUserTransactionHistoryResultFragment],
 );
-export type UserSuppliesRequest = RequestOf<typeof UserSuppliesQuery>;
+export type UserTransactionHistoryRequest = RequestOf<
+  typeof UserTransactionHistoryQuery
+>;

packages/react/README.md

@@ -4,4 +4,57 @@ The official React bindings for the Aave Protocol.
 
 ---
 
+## Usage
 
+### Setup
+
+```typescript
+// client.ts
+import { AaveClient } from '@aave/react';
+
+export const client = AaveClient.create();
+```
+
+```tsx
+// App.tsx
+import { AaveProvider } from '@aave/react';
+import { client } from './client';
+
+export function App() {
+  return (
+    <AaveProvider client={client}>
+      <MarketData />
+      <UserPositions />
+    </AaveProvider>
+  );
+}
+```
+
+### Query Data
+
+```tsx
+import { evmAddress, useAaveChains, useUserSupplies } from '@aave/react';
+
+function MarketData() {
+  const { data: chains, loading } = useAaveChains();
+  
+  if (loading) return <div>Loading...</div>;
+  
+  return (
+    <div>
+      {chains?.map(chain => (
+        <div key={chain.id}>{chain.name}</div>
+      ))}
+    </div>
+  );
+}
+
+function UserPositions() {
+  const { data: supplies } = useUserSupplies({
+    markets: [evmAddress('0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2')],
+    user: evmAddress('0x742d35cc6e5c4ce3b69a2a8c7c8e5f7e9a0b1234'),
+  });
+  
+  return <div>Supplies: {supplies?.length || 0}</div>;
+}
+```

packages/react/src/user.ts

@@ -6,6 +6,7 @@ import type {
   UserBorrowsRequest,
   UserMarketStateRequest,
   UserSuppliesRequest,
+  UserTransactionHistoryRequest,
 } from '@aave/graphql';
 import {
   UserBorrowsQuery,
@@ -178,6 +179,8 @@ export function useUserMarketState({
   });
 }
 
+export type UseUserTransactionHistoryArgs = UserTransactionHistoryRequest;
+
 /**
  * Fetch user transaction history.
  *
@@ -190,7 +193,7 @@ export function useUserMarketState({
  * ```
  */
 export function useUserTransactionHistory(
-  args: Suspendable,
+  args: UseUserTransactionHistoryArgs & Suspendable,
 ): SuspenseResult<PaginatedUserTransactionHistoryResult>;
 
 /**
@@ -200,16 +203,19 @@ export function useUserTransactionHistory(
  * const { data, loading } = useUserTransactionHistory();
  * ```
  */
-export function useUserTransactionHistory(): ReadResult<PaginatedUserTransactionHistoryResult>;
+export function useUserTransactionHistory(
+  args: UseUserTransactionHistoryArgs,
+): ReadResult<PaginatedUserTransactionHistoryResult>;
 
 export function useUserTransactionHistory({
   suspense = false,
-}: {
+  ...request
+}: UseUserTransactionHistoryArgs & {
   suspense?: boolean;
-} = {}): SuspendableResult<PaginatedUserTransactionHistoryResult> {
+}): SuspendableResult<PaginatedUserTransactionHistoryResult> {
   return useSuspendableQuery({
     document: UserTransactionHistoryQuery,
-    variables: {},
+    variables: { request },
     suspense,
   });
 }