@aave/client 4.0.0-next.2 → 4.0.0-next.21

package/dist/actions/index.d.cts

@@ -1,10 +1,10 @@
-import { UnexpectedError, TimeoutError } from '@aave/core';
-import { HubRequest, Hub, HubsRequest, HubAssetsRequest, HubAsset, ChainRequest, Chain, ChainsFilter, HasProcessedKnownTransactionRequest, ExchangeRateRequest, FiatAmount, PermitRequest, PermitTypedDataResponse, AssetRequest, Asset, AssetPriceHistoryRequest, AssetPriceSample, AssetSupplyHistoryRequest, AssetSupplySample, AssetBorrowHistoryRequest, AssetBorrowSample, ReserveRequest, Reserve, ReservesRequest, BorrowAPYHistoryRequest, APYSample, SupplyAPYHistoryRequest, SpokeRequest, Spoke, SpokesRequest, SpokePositionManagersRequest, PaginatedSpokePositionManagerResult, SpokeUserPositionManagersRequest, PaginatedSpokeUserPositionManagerResult, SwapQuoteRequest, SwapQuote, SwappableTokensRequest, Token, PrepareSwapRequest, PrepareSwapResult, SwapStatusRequest, SwapStatus, SwapCancelled, SwapExpired, SwapFulfilled, SwapReceipt, SwapRequest, SwapExecutionPlan, PrepareSwapCancelRequest, PrepareSwapCancelResult, CancelSwapRequest, CancelSwapExecutionPlan, UserSwapsRequest, PaginatedUserSwapsResult, BorrowRequest, ExecutionPlan, SupplyRequest, RepayRequest, WithdrawRequest, RenounceSpokeUserPositionManagerRequest, TransactionRequest, UpdateUserDynamicConfigRequest, UpdateUserRiskPremiumRequest, LiquidatePositionRequest, SetSpokeUserPositionManagerRequest, PreviewRequest, PreviewUserPosition, SetUserSupplyAsCollateralRequest, ActivitiesRequest, PaginatedActivitiesResult, UserSuppliesRequest, UserSupplyItem, UserBorrowsRequest, UserBorrowItem, UserSummaryRequest, UserSummary, UserPositionsRequest, UserPosition, UserPositionRequest, UserBalancesRequest, UserBalance, UserSummaryHistoryRequest, UserSummaryHistoryItem } from '@aave/graphql';
+import { UnexpectedError, ValidationError, TimeoutError } from '@aave/core';
+import { HubRequest, Hub, HubsRequest, HubAssetsRequest, HubAsset, HubSummaryHistoryRequest, HubSummarySample, ChainRequest, Chain, ChainsRequest, HasProcessedKnownTransactionRequest, ExchangeRateRequest, ExchangeAmount, PermitRequest, PermitTypedDataResponse, AssetRequest, Asset, AssetPriceHistoryRequest, AssetPriceSample, AssetSupplyHistoryRequest, AssetSupplySample, AssetBorrowHistoryRequest, AssetBorrowSample, ProtocolHistoryRequest, ProtocolHistorySample, ReserveRequest, Reserve, ReservesRequest, BorrowApyHistoryRequest, ApySample, SupplyApyHistoryRequest, SpokeRequest, Spoke, SpokesRequest, SpokePositionManagersRequest, PaginatedSpokePositionManagerResult, SpokeUserPositionManagersRequest, PaginatedSpokeUserPositionManagerResult, TokenSwapQuoteRequest, TokenSwapQuoteResult, SwappableTokensRequest, Token, PrepareTokenSwapRequest, PrepareSwapOrder, InsufficientBalanceError, SupplySwapQuoteRequest, PositionSwapByIntentApprovalsRequired, BorrowSwapQuoteRequest, RepayWithSupplyQuoteRequest, WithdrawSwapQuoteRequest, PreparePositionSwapRequest, SwapStatusRequest, SwapStatus, SwapCancelled, SwapExpired, SwapFulfilled, SwapReceipt, SwapRequest, SwapTransactionRequest, PrepareSwapCancelRequest, PrepareSwapCancelResult, CancelSwapRequest, CancelSwapExecutionPlan, UserSwapsRequest, PaginatedUserSwapsResult, BorrowRequest, ExecutionPlan, SupplyRequest, RepayRequest, WithdrawRequest, RenounceSpokeUserPositionManagerRequest, TransactionRequest, UpdateUserPositionConditionsRequest, LiquidatePositionRequest, SetSpokeUserPositionManagerRequest, PreviewRequest, PreviewUserPosition, SetUserSuppliesAsCollateralRequest, ActivitiesRequest, PaginatedActivitiesResult, UserSuppliesRequest, UserSupplyItem, UserBorrowsRequest, UserBorrowItem, UserSummaryRequest, UserSummary, UserPositionsRequest, UserPosition, UserPositionRequest, UserBalancesRequest, UserBalance, UserSummaryHistoryRequest, UserSummaryHistoryItem, UserRiskPremiumBreakdownRequest, UserRiskPremiumBreakdownItem } from '@aave/graphql';
 import { ResultAsync, Prettify } from '@aave/types';
-import { A as AaveClient } from '../AaveClient-L3v8kWvn.cjs';
-import { C as CurrencyQueryOptions, R as RequestPolicyOptions, T as TimeWindowQueryOptions } from '../options-vB2peXdE.cjs';
+import { A as AaveClient } from '../AaveClient-BIfAdE-4.cjs';
+import { C as CurrencyQueryOptions, T as TimeWindowQueryOptions, R as RequestPolicyOptions, B as BatchOptions } from '../options-BX6n3sbh.cjs';
 import '@urql/core';
-import '../types-Bu63z0x6.cjs';
+import '../types-CQvue0x0.cjs';
 
 /**
  * Fetches a specific hub by ID or by address and chain ID.
@@ -20,7 +20,7 @@ import '../types-Bu63z0x6.cjs';
  * @param options - The query options.
  * @returns The hub data, or null if not found.
  */
-declare function hub(client: AaveClient, request: HubRequest, options?: CurrencyQueryOptions & RequestPolicyOptions): ResultAsync<Hub | null, UnexpectedError>;
+declare function hub(client: AaveClient, request: HubRequest, options?: CurrencyQueryOptions & TimeWindowQueryOptions & RequestPolicyOptions): ResultAsync<Hub | null, UnexpectedError>;
 /**
  * Fetches multiple hubs based on specified criteria.
  *
@@ -37,7 +37,7 @@ declare function hub(client: AaveClient, request: HubRequest, options?: Currency
  * @param options - The query options.
  * @returns Array of hub data.
  */
-declare function hubs(client: AaveClient, request: HubsRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<Hub[], UnexpectedError>;
+declare function hubs(client: AaveClient, request: HubsRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<Hub[], UnexpectedError>;
 /**
  * Fetches hub assets for a specific hub by ID or by address and chain ID.
  *
@@ -52,7 +52,23 @@ declare function hubs(client: AaveClient, request: HubsRequest, options?: Requir
  * @param options - The query options.
  * @returns The hub assets array.
  */
-declare function hubAssets(client: AaveClient, request: HubAssetsRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<HubAsset[], UnexpectedError>;
+declare function hubAssets(client: AaveClient, request: HubAssetsRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<HubAsset[], UnexpectedError>;
+/**
+ * Fetches historical summary data for a specific hub.
+ *
+ * ```ts
+ * const result = await hubSummaryHistory(client, {
+ *   query: { hubId: hubId('SGVsbG8h') },
+ *   currency: Currency.Usd,
+ *   window: TimeWindow.LastWeek,
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The hub summary history request parameters.
+ * @returns Array of hub summary samples over time.
+ */
+declare function hubSummaryHistory(client: AaveClient, request: HubSummaryHistoryRequest): ResultAsync<HubSummarySample[], UnexpectedError>;
 
 /**
  * Fetches a specific chain by chain ID.
@@ -68,18 +84,30 @@ declare function hubAssets(client: AaveClient, request: HubAssetsRequest, option
  * @returns The chain data, or null if not found.
  */
 declare function chain(client: AaveClient, request: ChainRequest): ResultAsync<Chain | null, UnexpectedError>;
+/**
+ * @internal
+ */
+declare function chain(client: AaveClient, request: ChainRequest, options: BatchOptions): ResultAsync<Chain | null, UnexpectedError>;
 /**
  * Fetches the list of supported chains.
  *
  * ```ts
- * const chains = await chains(client, { filter: ChainsFilter.ALL });
+ * const chains = await chains(client, {
+ *   query: { filter: ChainsFilter.ALL }
+ * });
+ * ```
+ *
+ * ```ts
+ * const chains = await chains(client, {
+ *   query: { chainIds: [chainId(1), chainId(137)] }
+ * });
  * ```
  *
  * @param client - Aave client.
- * @param filter - The filter for chains.
+ * @param request - The chains request parameters.
  * @returns Array of supported chains.
  */
-declare function chains(client: AaveClient, filter?: ChainsFilter): ResultAsync<Chain[], UnexpectedError>;
+declare function chains(client: AaveClient, request: ChainsRequest): ResultAsync<Chain[], UnexpectedError>;
 /**
  * Check if a transaction has been processed by the Aave API.
  *
@@ -102,7 +130,7 @@ declare function hasProcessedKnownTransaction(client: AaveClient, request: HasPr
  * @param request - The exchange rate request parameters.
  * @returns The exchange rate information as a fiat amount.
  */
-declare function exchangeRate(client: AaveClient, request: ExchangeRateRequest): ResultAsync<FiatAmount, UnexpectedError>;
+declare function exchangeRate(client: AaveClient, request: ExchangeRateRequest): ResultAsync<ExchangeAmount, UnexpectedError>;
 
 /**
  * Generates EIP-712 typed data for permit signatures.
@@ -140,13 +168,15 @@ declare function permitTypedData(client: AaveClient, request: PermitRequest): Re
  * @param options - The query options including currency and time window.
  * @returns The asset data, or null if not found.
  */
-declare function asset(client: AaveClient, request: AssetRequest, options?: CurrencyQueryOptions & TimeWindowQueryOptions & RequestPolicyOptions): ResultAsync<Asset | null, UnexpectedError>;
+declare function asset(client: AaveClient, request: AssetRequest, { currency, timeWindow, requestPolicy, }?: CurrencyQueryOptions & TimeWindowQueryOptions & RequestPolicyOptions): ResultAsync<Asset | null, UnexpectedError>;
 /**
  * Fetches historical price data for a specific asset.
  *
  * ```ts
  * const result = await assetPriceHistory(client, {
- *   token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   query: {
+ *     token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   },
  *   currency: Currency.Usd,
  *   window: TimeWindow.LastWeek,
  * });
@@ -163,7 +193,9 @@ declare function assetPriceHistory(client: AaveClient, request: AssetPriceHistor
  *
  * ```ts
  * const result = await assetSupplyHistory(client, {
- *   token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   query: {
+ *     token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   },
  *   window: TimeWindow.LastWeek,
  * });
  * ```
@@ -179,7 +211,9 @@ declare function assetSupplyHistory(client: AaveClient, request: AssetSupplyHist
  *
  * ```ts
  * const result = await assetBorrowHistory(client, {
- *   token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   query: {
+ *     token: { chainId: chainId(1), address: evmAddress('0x123…') },
+ *   },
  *   window: TimeWindow.LastWeek,
  * });
  * ```
@@ -190,6 +224,22 @@ declare function assetSupplyHistory(client: AaveClient, request: AssetSupplyHist
  * @returns Array of asset borrow samples over time.
  */
 declare function assetBorrowHistory(client: AaveClient, request: AssetBorrowHistoryRequest, options?: Required<RequestPolicyOptions>): ResultAsync<AssetBorrowSample[], UnexpectedError>;
+/**
+ * Fetches historical protocol-wide data (deposits, borrows, earnings).
+ *
+ * ```ts
+ * const result = await protocolHistory(client, {
+ *   currency: Currency.Usd,
+ *   window: TimeWindow.LastWeek,
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The protocol history request parameters.
+ * @param options - The query options.
+ * @returns Array of protocol history samples over time.
+ */
+declare function protocolHistory(client: AaveClient, request: ProtocolHistoryRequest, options?: Required<RequestPolicyOptions>): ResultAsync<ProtocolHistorySample[], UnexpectedError>;
 
 /**
  * Fetches a specific reserve by reserve ID, spoke, and chain.
@@ -206,7 +256,7 @@ declare function assetBorrowHistory(client: AaveClient, request: AssetBorrowHist
  * @param options - The query options.
  * @returns The reserve data, or null if not found.
  */
-declare function reserve(client: AaveClient, request: ReserveRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<Reserve | null, UnexpectedError>;
+declare function reserve(client: AaveClient, request: ReserveRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<Reserve | null, UnexpectedError>;
 /**
  * Fetches reserves based on specified criteria.
  *
@@ -228,7 +278,7 @@ declare function reserve(client: AaveClient, request: ReserveRequest, options?:
  * @param options - The query options.
  * @returns Array of reserves matching the criteria.
  */
-declare function reserves(client: AaveClient, request: ReservesRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<Reserve[], UnexpectedError>;
+declare function reserves(client: AaveClient, request: ReservesRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<Reserve[], UnexpectedError>;
 /**
  * Fetches borrow APY history for a specific reserve over time.
  *
@@ -243,7 +293,7 @@ declare function reserves(client: AaveClient, request: ReservesRequest, options?
  * @param request - The borrow APY history request parameters.
  * @returns The borrow APY history samples.
  */
-declare function borrowApyHistory(client: AaveClient, request: BorrowAPYHistoryRequest): ResultAsync<APYSample[], UnexpectedError>;
+declare function borrowApyHistory(client: AaveClient, request: BorrowApyHistoryRequest): ResultAsync<ApySample[], UnexpectedError>;
 /**
  * Fetches supply APY history for a specific reserve over time.
  *
@@ -258,7 +308,7 @@ declare function borrowApyHistory(client: AaveClient, request: BorrowAPYHistoryR
  * @param request - The supply APY history request parameters.
  * @returns The supply APY history samples.
  */
-declare function supplyApyHistory(client: AaveClient, request: SupplyAPYHistoryRequest): ResultAsync<APYSample[], UnexpectedError>;
+declare function supplyApyHistory(client: AaveClient, request: SupplyApyHistoryRequest): ResultAsync<ApySample[], UnexpectedError>;
 
 /**
  * Fetches a specific spoke.
@@ -319,28 +369,28 @@ declare function spokePositionManagers(client: AaveClient, request: SpokePositio
 declare function spokeUserPositionManagers(client: AaveClient, request: SpokeUserPositionManagersRequest): ResultAsync<PaginatedSpokeUserPositionManagerResult, UnexpectedError>;
 
 /**
- * @internal
  * Fetches a swap quote for the specified trade parameters.
  *
  * ```ts
- * const result = await swapQuote(client, {
- *   chainId: chainId(1),
- *   buy: { erc20: evmAddress('0xA0b86a33E6...') },
- *   sell: { erc20: evmAddress('0x6B175474E...') },
- *   amount: bigDecimal('1000'),
- *   kind: SwapKind.SELL,
- *   from: evmAddress('0x742d35cc...'),
+ * const result = await tokenSwapQuote(client, {
+ *   market: {
+ *     chainId: chainId(1),
+ *     buy: { erc20: evmAddress('0xA0b86a33E6...') },
+ *     sell: { erc20: evmAddress('0x6B175474E...') },
+ *     amount: bigDecimal('1000'),
+ *     kind: SwapKind.Sell,
+ *     user: evmAddress('0x742d35cc...'),
+ *   },
  * });
  * ```
  *
  * @param client - Aave client.
  * @param request - The swap quote request parameters.
  * @param options - The query options.
- * @returns The swap quote including pricing and cost information.
+ * @returns The swap quote including pricing and cost information and plan to start executing the swap.
  */
-declare function swapQuote(client: AaveClient, request: SwapQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<SwapQuote, UnexpectedError>;
+declare function tokenSwapQuote(client: AaveClient, request: TokenSwapQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<TokenSwapQuoteResult, UnexpectedError>;
 /**
- * @internal
  * Fetches the list of tokens available for swapping on a specific chain.
  *
  * ```ts
@@ -355,59 +405,121 @@ declare function swapQuote(client: AaveClient, request: SwapQuoteRequest, option
  */
 declare function swappableTokens(client: AaveClient, request: SwappableTokensRequest): ResultAsync<Token[], UnexpectedError>;
 /**
- * @internal
  * Prepares a swap for the specified trade parameters.
  *
  * ```ts
- * const result = await prepareSwap(client, {
+ * const result = await prepareTokenSwap(client, {
+ *   quoteId: quote.quoteId,
+ * }).andThen(order => {
+ *   return signSwapTypedDataWith(wallet, order.data)
+ *     .andThen((signature) =>
+ *       swap({ intent: { quoteId: order.newQuoteId, signature } }),
+ *     );
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The prepare swap request parameters.
+ * @returns The prepared swap result containing details of the swap.
+ */
+declare function prepareTokenSwap(client: AaveClient, request: PrepareTokenSwapRequest): ResultAsync<PrepareSwapOrder, ValidationError<InsufficientBalanceError> | UnexpectedError>;
+/**
+ * Fetches a supply swap quote for swapping deposited funds.
+ *
+ * ```ts
+ * const result = await supplySwapQuote(client, {
  *   market: {
- *     chainId: chainId(1),
- *     buy: { erc20: evmAddress('0xA0b86a33E6...') },
- *     sell: { erc20: evmAddress('0x6B175474E...') },
+ *     sellPosition: userSupplyItemId('position_123'),
+ *     buyReserve: reserveId('reserve_456'),
  *     amount: bigDecimal('1000'),
- *     kind: SwapKind.SELL,
  *     user: evmAddress('0x742d35cc...'),
  *   },
- * }).andThen(plan => {
- *   switch (plan.__typename) {
- *     case 'SwapByIntent':
- *       return signSwapByIntentWith(plan.data)
- *         .andThen((signature) => swap({ intent: { quoteId: quote.quoteId, signature } }))
- *         .andThen((plan) => {
- *           // …
- *         });
- *       );
- *
- *     case 'SwapByIntentWithApprovalRequired':
- *       return sendTransaction(plan.transaction)
- *         .andThen(signSwapByIntentWith(plan.data))
- *         .andThen((signature) => swap({ intent: { quoteId: quote.quoteId, signature } }))
- *         .andThen((plan) => {
- *         // …
- *         });
- *       );
- *
- *     case 'SwapByTransaction':
- *       return swap({ transaction: { quoteId: quote.quoteId } })
- *         .andThen((plan) => {
- *           // …
- *         });
- *       );
- *
- *     case 'InsufficientBalanceError':
- *       return errAsync(new Error(`Insufficient balance: ${plan.required.value} required.`));
- *   }
  * });
  * ```
  *
  * @param client - Aave client.
- * @param request - The prepare swap request parameters.
+ * @param request - The supply swap request parameters.
  * @param options - The query options.
- * @returns The prepared swap result containing details of the swap.
+ * @returns The supply swap result with quote, approvals, and preview.
  */
-declare function prepareSwap(client: AaveClient, request: PrepareSwapRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PrepareSwapResult, UnexpectedError>;
+declare function supplySwapQuote(client: AaveClient, request: SupplySwapQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PositionSwapByIntentApprovalsRequired, UnexpectedError>;
+/**
+ * Fetches a borrow swap quote for swapping debt positions.
+ *
+ * ```ts
+ * const result = await borrowSwapQuote(client, {
+ *   market: {
+ *     sellPosition: userBorrowItemId('position_123'),
+ *     buyReserve: reserveId('reserve_456'),
+ *     amount: bigDecimal('1000'),
+ *     user: evmAddress('0x742d35cc...'),
+ *   },
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The borrow swap request parameters.
+ * @param options - The query options.
+ * @returns The borrow swap result with quote, approvals, and preview.
+ */
+declare function borrowSwapQuote(client: AaveClient, request: BorrowSwapQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PositionSwapByIntentApprovalsRequired, UnexpectedError>;
+/**
+ * Fetches a repay with supply quote for repaying debt using collateral.
+ *
+ * ```ts
+ * const result = await repayWithSupplyQuote(client, {
+ *   market: {
+ *     sellPosition: userSupplyItemId('collateral_123'),
+ *     buyPosition: userBorrowItemId('debt_456'),
+ *     amount: bigDecimal('1000'),
+ *     user: evmAddress('0x742d35cc...'),
+ *   },
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The repay with supply request parameters.
+ * @param options - The query options.
+ * @returns The repay with supply result with quote, approvals, and preview.
+ */
+declare function repayWithSupplyQuote(client: AaveClient, request: RepayWithSupplyQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PositionSwapByIntentApprovalsRequired, UnexpectedError>;
+/**
+ * Fetches a withdraw swap quote for withdrawing deposits and swapping on the fly.
+ *
+ * ```ts
+ * const result = await withdrawSwapQuote(client, {
+ *   market: {
+ *     position: userSupplyItemId('position_123'),
+ *     buyReserve: reserveId('reserve_456'),
+ *     amount: bigDecimal('1000'),
+ *     user: evmAddress('0x742d35cc...'),
+ *   },
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The withdraw swap request parameters.
+ * @param options - The query options.
+ * @returns The withdraw swap result with quote, approvals, and preview.
+ */
+declare function withdrawSwapQuote(client: AaveClient, request: WithdrawSwapQuoteRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PositionSwapByIntentApprovalsRequired, UnexpectedError>;
+/**
+ * Prepares a position swap by obtaining the typed data for signing.
+ *
+ * ```ts
+ * const result = await preparePositionSwap(client, {
+ *   quoteId: quote.quoteId,
+ *   adapterContractSignature: signature('0x456...'),
+ *   positionManagerSignature: signature('0x789...'),
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The position swap request with quote ID and signatures.
+ * @returns The position swap result with intent data for execution.
+ */
+declare function preparePositionSwap(client: AaveClient, request: PreparePositionSwapRequest): ResultAsync<PrepareSwapOrder, ValidationError<InsufficientBalanceError> | UnexpectedError>;
 /**
- * @internal
  * Fetches the status of a specific swap.
  *
  * ```ts
@@ -421,10 +533,9 @@ declare function prepareSwap(client: AaveClient, request: PrepareSwapRequest, op
  * @param options - The query options.
  * @returns The current status of the swap.
  */
-declare function swapStatus(client: AaveClient, request: SwapStatusRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<SwapStatus, UnexpectedError>;
+declare function swapStatus(client: AaveClient, request: SwapStatusRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<SwapStatus, UnexpectedError>;
 type SwapOutcome = SwapCancelled | SwapExpired | SwapFulfilled;
 /**
- * @internal
  * Waits for a swap to reach a final outcome (cancelled, expired, or fulfilled).
  *
  * ```ts
@@ -451,17 +562,13 @@ type SwapOutcome = SwapCancelled | SwapExpired | SwapFulfilled;
  */
 declare function waitForSwapOutcome(client: AaveClient): (receipt: SwapReceipt) => ResultAsync<SwapOutcome, TimeoutError | UnexpectedError>;
 /**
- * @internal
  * Executes a swap for the specified request parameters.
  *
  * ```ts
  * const result = await swap(client, {
  *   intent: {
- *     quoteId: swapQuoteId('123...'),
- *     signature: {
- *       value: signature('0x456...'),
- *       deadline: 1234567890,
- *     },
+ *     quoteId: quote.quoteId,
+ *     signature: signature('0x456...'),
  *   },
  * }).andThen((plan) => {
  *   switch (plan.__typename) {
@@ -469,16 +576,8 @@ declare function waitForSwapOutcome(client: AaveClient): (receipt: SwapReceipt)
  *       return sendTransaction(plan.transaction)
  *         .map(() => plan.orderReceipt);
  *
- *     case 'SwapApprovalRequired':
- *       return sendTransaction(plan.transaction)
- *         .andThen(() => sendTransaction(plan.originalTransaction))
- *         .map(() => plan.originalTransaction.orderReceipt);
- *
  *     case 'SwapReceipt':
- *       return okAsync(plan.orderReceipt);
- *
- *     case 'InsufficientBalanceError':
- *       return errAsync(new Error(`Insufficient balance: ${plan.required.value} required.`));
+ *       return okAsync(plan);
  *   }
  * });
  *
@@ -494,9 +593,8 @@ declare function waitForSwapOutcome(client: AaveClient): (receipt: SwapReceipt)
  * @param request - The swap request parameters.
  * @returns The swap execution plan containing transaction details or receipt.
  */
-declare function swap(client: AaveClient, request: SwapRequest): ResultAsync<SwapExecutionPlan, UnexpectedError>;
+declare function swap(client: AaveClient, request: SwapRequest): ResultAsync<SwapTransactionRequest | SwapReceipt, ValidationError<InsufficientBalanceError> | UnexpectedError>;
 /**
- * @internal
  * Prepares a swap cancellation for the specified swap ID.
  *
  * ```ts
@@ -511,7 +609,6 @@ declare function swap(client: AaveClient, request: SwapRequest): ResultAsync<Swa
  */
 declare function prepareSwapCancel(client: AaveClient, request: PrepareSwapCancelRequest): ResultAsync<PrepareSwapCancelResult, UnexpectedError>;
 /**
- * @internal
  * Executes a swap cancellation for the specified request parameters.
  *
  * ```ts
@@ -526,8 +623,7 @@ declare function prepareSwapCancel(client: AaveClient, request: PrepareSwapCance
  * }).andThen((plan) => {
  *   switch (plan.__typename) {
  *     case 'TransactionRequest':
- *       return sendTransaction(plan)
- *         .map(() => ({ success: true }));
+ *       return sendTransaction(plan);
  *
  *     case 'SwapCancelled':
  *       return okAsync(plan);
@@ -541,7 +637,6 @@ declare function prepareSwapCancel(client: AaveClient, request: PrepareSwapCance
  */
 declare function cancelSwap(client: AaveClient, request: CancelSwapRequest): ResultAsync<CancelSwapExecutionPlan, UnexpectedError>;
 /**
- * @internal
  * Fetches the user's swap history for a specific chain.
  *
  * ```ts
@@ -557,7 +652,7 @@ declare function cancelSwap(client: AaveClient, request: CancelSwapRequest): Res
  * @param options - The query options.
  * @returns The paginated list of user swaps with their status information.
  */
-declare function userSwaps(client: AaveClient, request: UserSwapsRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PaginatedUserSwapsResult, UnexpectedError>;
+declare function userSwaps(client: AaveClient, request: UserSwapsRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<PaginatedUserSwapsResult, UnexpectedError>;
 
 /**
  * Creates a transaction to borrow from a market.
@@ -724,35 +819,12 @@ declare function withdraw(client: AaveClient, request: WithdrawRequest): ResultA
  */
 declare function renounceSpokeUserPositionManager(client: AaveClient, request: RenounceSpokeUserPositionManagerRequest): ResultAsync<TransactionRequest, UnexpectedError>;
 /**
- * Creates a transaction to update user dynamic config for a specific spoke.
- *
- * ```ts
- * const result = await updateUserDynamicConfig(client, {
- *   sender: evmAddress('0x9abc…'),
- *   spoke: spokeId('SGVsbG8h'),
- * }).andThen(sendWith(wallet)).andThen(client.waitForTransaction);
- *
- * if (result.isErr()) {
- *   // Handle error
- *   return;
- * }
- *
- * // result.value: TxHash
- * ```
- *
- *
- * @param client - Aave client.
- * @param request - The update user dynamic config request parameters.
- * @returns The transaction data.
- */
-declare function updateUserDynamicConfig(client: AaveClient, request: UpdateUserDynamicConfigRequest): ResultAsync<TransactionRequest, UnexpectedError>;
-/**
- * Creates a transaction to update user risk premium for a specific spoke.
+ * Creates a transaction to update user position conditions (dynamic config and/or risk premium).
  *
  * ```ts
- * const result = await updateUserRiskPremium(client, {
- *   sender: evmAddress('0x9abc…'),
- *   spoke: spokeId('SGVsbG8h'),
+ * const result = await updateUserPositionConditions(client, {
+ *   userPositionId: userPositionId('SGVsbG8h'),
+ *   update: UserPositionConditionsUpdate.AllDynamicConfig,
  * }).andThen(sendWith(wallet)).andThen(client.waitForTransaction);
  *
  * if (result.isErr()) {
@@ -765,10 +837,10 @@ declare function updateUserDynamicConfig(client: AaveClient, request: UpdateUser
  *
  *
  * @param client - Aave client.
- * @param request - The update user risk premium request parameters.
+ * @param request - The update user position conditions request parameters.
  * @returns The transaction data.
  */
-declare function updateUserRiskPremium(client: AaveClient, request: UpdateUserRiskPremiumRequest): ResultAsync<TransactionRequest, UnexpectedError>;
+declare function updateUserPositionConditions(client: AaveClient, request: UpdateUserPositionConditionsRequest): ResultAsync<TransactionRequest, UnexpectedError>;
 /**
  * Creates a transaction to liquidate a user's position.
  *
@@ -861,21 +933,25 @@ declare function setSpokeUserPositionManager(client: AaveClient, request: SetSpo
  */
 declare function preview(client: AaveClient, request: PreviewRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<PreviewUserPosition, UnexpectedError>;
 /**
- * Sets whether a user's supply should be used as collateral.
+ * Updates the collateral status of user's supplies.
  *
  * ```ts
- * const result = await setUserSupplyAsCollateral(client, {
- *   reserve: reserveId('SGVsbG8h'),
- *   sender: evmAddress('0x456...'),
- *   enableCollateral: true
+ * const result = await setUserSuppliesAsCollateral(client, {
+ *   changes: [
+ *     {
+ *       reserve: reserveId('SGVsbG8h'),
+ *       enableCollateral: true
+ *     }
+ *   ],
+ *   sender: evmAddress('0x456...')
  * });
  * ```
  *
  * @param client - Aave client.
- * @param request - The set user supply as collateral request parameters.
- * @returns The transaction request to set collateral status.
+ * @param request - The request parameters.
+ * @returns The transaction request to update collateral status.
  */
-declare function setUserSupplyAsCollateral(client: AaveClient, request: SetUserSupplyAsCollateralRequest): ResultAsync<TransactionRequest, UnexpectedError>;
+declare function setUserSuppliesAsCollateral(client: AaveClient, request: SetUserSuppliesAsCollateralRequest): ResultAsync<TransactionRequest, UnexpectedError>;
 /**
  * Fetches paginated list of activities.
  *
@@ -894,7 +970,7 @@ declare function setUserSupplyAsCollateral(client: AaveClient, request: SetUserS
  * @param options - The query options.
  * @returns The paginated list of activities.
  */
-declare function activities(client: AaveClient, request: ActivitiesRequest, options?: CurrencyQueryOptions & RequestPolicyOptions): ResultAsync<PaginatedActivitiesResult, UnexpectedError>;
+declare function activities(client: AaveClient, request: ActivitiesRequest, { currency, timeWindow, requestPolicy, }?: CurrencyQueryOptions & TimeWindowQueryOptions & RequestPolicyOptions): ResultAsync<PaginatedActivitiesResult, UnexpectedError>;
 
 /**
  * Fetches all user supply positions across the specified spoke.
@@ -916,7 +992,7 @@ declare function activities(client: AaveClient, request: ActivitiesRequest, opti
  * @param options - The query options.
  * @returns The user's supply positions.
  */
-declare function userSupplies(client: AaveClient, request: UserSuppliesRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<UserSupplyItem[], UnexpectedError>;
+declare function userSupplies(client: AaveClient, request: UserSuppliesRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<UserSupplyItem[], UnexpectedError>;
 /**
  * Fetches all user borrow positions across the specified spoke.
  *
@@ -937,7 +1013,7 @@ declare function userSupplies(client: AaveClient, request: UserSuppliesRequest,
  * @param options - The query options.
  * @returns The user's borrow positions.
  */
-declare function userBorrows(client: AaveClient, request: UserBorrowsRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<UserBorrowItem[], UnexpectedError>;
+declare function userBorrows(client: AaveClient, request: UserBorrowsRequest, { currency, timeWindow, }?: CurrencyQueryOptions & TimeWindowQueryOptions): ResultAsync<UserBorrowItem[], UnexpectedError>;
 type UserSummaryQueryOptions = Prettify<CurrencyQueryOptions & TimeWindowQueryOptions>;
 /**
  * Fetches a user's summary across all positions.
@@ -1029,5 +1105,22 @@ declare function userBalances(client: AaveClient, request: UserBalancesRequest,
  * @returns The user summary history items.
  */
 declare function userSummaryHistory(client: AaveClient, request: UserSummaryHistoryRequest, options?: Required<CurrencyQueryOptions>): ResultAsync<UserSummaryHistoryItem[], UnexpectedError>;
+/**
+ * Fetches the risk premium breakdown for a user position or spoke.
+ *
+ * ```ts
+ * const result = await userRiskPremiumBreakdown(client, {
+ *   query: {
+ *     userPositionId: userPositionId('SGVsbG8h'),
+ *   },
+ *   user: evmAddress('0x742d35cc…'),
+ * });
+ * ```
+ *
+ * @param client - Aave client.
+ * @param request - The user risk premium breakdown request parameters.
+ * @returns Array of risk premium breakdown items.
+ */
+declare function userRiskPremiumBreakdown(client: AaveClient, request: UserRiskPremiumBreakdownRequest): ResultAsync<UserRiskPremiumBreakdownItem[], UnexpectedError>;
 
-export { type SwapOutcome, type UserPositionQueryOptions, type UserSummaryQueryOptions, activities, asset, assetBorrowHistory, assetPriceHistory, assetSupplyHistory, borrow, borrowApyHistory, cancelSwap, chain, chains, exchangeRate, hasProcessedKnownTransaction, hub, hubAssets, hubs, liquidatePosition, permitTypedData, prepareSwap, prepareSwapCancel, preview, renounceSpokeUserPositionManager, repay, reserve, reserves, setSpokeUserPositionManager, setUserSupplyAsCollateral, spoke, spokePositionManagers, spokeUserPositionManagers, spokes, supply, supplyApyHistory, swap, swapQuote, swapStatus, swappableTokens, updateUserDynamicConfig, updateUserRiskPremium, userBalances, userBorrows, userPosition, userPositions, userSummary, userSummaryHistory, userSupplies, userSwaps, waitForSwapOutcome, withdraw };
+export { type SwapOutcome, type UserPositionQueryOptions, type UserSummaryQueryOptions, activities, asset, assetBorrowHistory, assetPriceHistory, assetSupplyHistory, borrow, borrowApyHistory, borrowSwapQuote, cancelSwap, chain, chains, exchangeRate, hasProcessedKnownTransaction, hub, hubAssets, hubSummaryHistory, hubs, liquidatePosition, permitTypedData, preparePositionSwap, prepareSwapCancel, prepareTokenSwap, preview, protocolHistory, renounceSpokeUserPositionManager, repay, repayWithSupplyQuote, reserve, reserves, setSpokeUserPositionManager, setUserSuppliesAsCollateral, spoke, spokePositionManagers, spokeUserPositionManagers, spokes, supply, supplyApyHistory, supplySwapQuote, swap, swapStatus, swappableTokens, tokenSwapQuote, updateUserPositionConditions, userBalances, userBorrows, userPosition, userPositions, userRiskPremiumBreakdown, userSummary, userSummaryHistory, userSupplies, userSwaps, waitForSwapOutcome, withdraw, withdrawSwapQuote };