feat: reserve action

Author: cesarenaldi

packages/client/src/actions/index.ts

@@ -1,2 +1,3 @@
 export * from './markets';
 export * from './misc';
+export * from './reserve';

packages/client/src/actions/reserve.ts

@@ -0,0 +1,30 @@
+import {
+  type Reserve,
+  ReserveQuery,
+  type ReserveRequest,
+} from '@aave/graphql';
+import type { ResultAsync } from '@aave/types';
+import type { AaveClient } from '../client';
+import type { UnexpectedError } from '../errors';
+
+/**
+ * Fetches a specific reserve by market address, token address, and chain ID.
+ *
+ * ```ts
+ * const result = await reserve(client, {
+ *   marketAddress: evmAddress('0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2'),
+ *   token: evmAddress('0xa0b86a33e6441c8c5f0bb9b7e5e1f8bbf5b78b5c'),
+ *   chainId: chainId(1)
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The reserve request parameters.
+ * @returns The reserve data, or null if not found.
+ */
+export function reserve(
+  client: AaveClient,
+  request: ReserveRequest,
+): ResultAsync<Reserve | null, UnexpectedError> {
+  return client.query(ReserveQuery, { request });
+}

packages/graphql/src/fragments/common.ts

@@ -10,3 +10,40 @@ export const DecimalValueFragment = graphql(
   }`,
 );
 export type DecimalValue = FragmentOf<typeof DecimalValueFragment>;
+
+export const CurrencyFragment = graphql(
+  `fragment Currency on Currency {
+    __typename
+    address
+    imageUrl
+    name
+    symbol
+    decimals
+    chainId
+  }`,
+);
+export type Currency = FragmentOf<typeof CurrencyFragment>;
+
+export const NativeCurrencyFragment = graphql(
+  `fragment NativeCurrency on NativeCurrency {
+    __typename
+    imageUrl
+    name
+    symbol
+    decimals
+    chainId
+  }`,
+);
+export type NativeCurrency = FragmentOf<typeof NativeCurrencyFragment>;
+
+export const TokenAmountFragment = graphql(
+  `fragment TokenAmount on TokenAmount {
+    __typename
+    amount {
+      ...DecimalValue
+    }
+    usd
+  }`,
+  [DecimalValueFragment],
+);
+export type TokenAmount = FragmentOf<typeof TokenAmountFragment>;

packages/graphql/src/fragments/index.ts

@@ -1,3 +1,4 @@
 export * from './chain';
 export * from './common';
 export * from './market';
+export * from './reserve';

packages/graphql/src/fragments/reserve.ts

@@ -0,0 +1,141 @@
+import type { FragmentOf } from 'gql.tada';
+import { graphql } from '../graphql';
+import { ChainFragment } from './chain';
+import { 
+  DecimalValueFragment, 
+  CurrencyFragment, 
+  NativeCurrencyFragment, 
+  TokenAmountFragment
+} from './common';
+
+export const EmodeInfoFragment = graphql(
+  `fragment EmodeInfo on EmodeInfo {
+    __typename
+    maxLTV {
+      ...DecimalValue
+    }
+    liquidationThreshold {
+      ...DecimalValue
+    }
+    liquidationPenalty {
+      ...DecimalValue
+    }
+  }`,
+  [DecimalValueFragment],
+);
+export type EmodeInfo = FragmentOf<typeof EmodeInfoFragment>;
+
+export const ReserveSupplyInfoFragment = graphql(
+  `fragment ReserveSupplyInfo on ReserveSupplyInfo {
+    __typename
+    apy {
+      ...DecimalValue
+    }
+    total {
+      ...DecimalValue
+    }
+    maxLTV {
+      ...DecimalValue
+    }
+    liquidationThreshold {
+      ...DecimalValue
+    }
+    liquidationPenalty {
+      ...DecimalValue
+    }
+    canBeCollateral
+  }`,
+  [DecimalValueFragment],
+);
+export type ReserveSupplyInfo = FragmentOf<typeof ReserveSupplyInfoFragment>;
+
+export const ReserveBorrowInfoFragment = graphql(
+  `fragment ReserveBorrowInfo on ReserveBorrowInfo {
+    __typename
+    apy {
+      ...DecimalValue
+    }
+    total {
+      ...DecimalValue
+    }
+    borrowCap {
+      ...DecimalValue
+    }
+    reserveFactor
+  }`,
+  [DecimalValueFragment],
+);
+export type ReserveBorrowInfo = FragmentOf<typeof ReserveBorrowInfoFragment>;
+
+export const ReserveUserAvailabilityFragment = graphql(
+  `fragment ReserveUserAvailability on ReserveUserAvailability {
+    __typename
+    balance {
+      ...DecimalValue
+    }
+    supply {
+      ...DecimalValue
+    }
+    borrow {
+      ...DecimalValue
+    }
+  }`,
+  [DecimalValueFragment],
+);
+export type ReserveUserAvailability = FragmentOf<typeof ReserveUserAvailabilityFragment>;
+
+export const ReserveFragment = graphql(
+  `fragment Reserve on Reserve {
+    __typename
+    market {
+      name
+      chain {
+        ...Chain
+      }
+    }
+    address
+    underlyingToken {
+      ...Currency
+    }
+    aToken {
+      ...Currency
+    }
+    vToken {
+      ...Currency
+    }
+    acceptsNative {
+      ...NativeCurrency
+    }
+    size {
+      ...TokenAmount
+    }
+    utilizationRate {
+      ...DecimalValue
+    }
+    available {
+      ...TokenAmount
+    }
+    usdExchangeRate
+    usdOracleAddress
+    supplyInfo {
+      ...ReserveSupplyInfo
+    }
+    borrowInfo {
+      ...ReserveBorrowInfo
+    }
+    eModeInfo {
+      ...EmodeInfo
+    }
+  }`,
+  [
+    ChainFragment,
+    CurrencyFragment,
+    NativeCurrencyFragment,
+    TokenAmountFragment,
+    DecimalValueFragment,
+    ReserveSupplyInfoFragment,
+    ReserveBorrowInfoFragment,
+    EmodeInfoFragment,
+  ],
+);
+export type Reserve = FragmentOf<typeof ReserveFragment>;

packages/graphql/src/index.ts

@@ -4,3 +4,4 @@ export * from './fragments';
 export * from './graphql';
 export * from './markets';
 export * from './misc';
+export * from './reserves';

packages/graphql/src/reserves.ts

@@ -0,0 +1,12 @@
+import { ReserveFragment } from './fragments';
+import { graphql, type RequestOf } from './graphql';
+
+export const ReserveQuery = graphql(
+  `query Reserve($request: ReserveRequest!) {
+    value: reserve(request: $request) {
+      ...Reserve
+    }
+  }`,
+  [ReserveFragment],
+);
+export type ReserveRequest = RequestOf<typeof ReserveQuery>;