@emberai/onchain-actions-registry 4.5.2-next.2 → 4.6.0-next.1

package/README.md

@@ -236,7 +236,7 @@ The schema system provides comprehensive type safety with Zod validation:
 
 **Action-Specific Schemas**:
 
-- **Lending** (`schemas/lending.ts`): Supply, borrow, repay, withdraw operations with comprehensive position tracking
+- **Lending** (`schemas/lending.ts`): Supply, borrow, repay, withdraw operations with comprehensive position tracking, optional `tokenAddress` targeting, and reserve quote fields for exact max-borrow resolution
 - **Liquidity** (`schemas/liquidity.ts`): Advanced liquidity provision with discriminated unions for full/limited range positions
 - **Swap** (`schemas/swap.ts`): Token exchange with slippage tolerance and price tracking
 - **Perpetuals** (`schemas/perpetuals.ts`): Integration with GMX SDK for complex derivatives trading

package/dist/index.cjs

@@ -166,15 +166,24 @@ const GetWalletLendingPositionsRequestSchema = zod.z.object({
 });
 const LendTokenDetailSchema = zod.z.object({
 	tokenUid: TokenIdentifierSchema,
+	symbol: zod.z.string().optional(),
+	name: zod.z.string().optional(),
+	decimals: zod.z.number().int().optional(),
 	underlyingBalance: zod.z.string(),
 	underlyingBalanceUsd: zod.z.string(),
 	variableBorrows: zod.z.string(),
 	variableBorrowsUsd: zod.z.string(),
 	totalBorrows: zod.z.string(),
-	totalBorrowsUsd: zod.z.string()
+	totalBorrowsUsd: zod.z.string(),
+	priceInUsd: zod.z.string(),
+	priceInMarketReferenceCurrency: zod.z.string(),
+	formattedPriceInMarketReferenceCurrency: zod.z.string(),
+	availableLiquidity: zod.z.string(),
+	availableLiquidityUsd: zod.z.string()
 });
 const GetWalletLendingPositionsResponseSchema = zod.z.object({
 	userReserves: zod.z.array(LendTokenDetailSchema),
+	requestedReserve: LendTokenDetailSchema.optional(),
 	totalLiquidityUsd: zod.z.string(),
 	totalCollateralUsd: zod.z.string(),
 	totalBorrowsUsd: zod.z.string(),
@@ -1240,13 +1249,14 @@ function formatNumeric(value) {
 }
 var UserSummary = class {
 	reserves;
+	formattedReserves;
 	/**
 	* @param userReservesResponse - The response from getUserReservesHumanized.
 	* @param reservesResponse - The response from getReservesHumanized.
 	*/
 	constructor(userReservesResponse, reservesResponse) {
 		const currentTimestamp = Date.now() / 1e3;
-		const formattedReserves = (0, __aave_math_utils.formatReserves)({
+		this.formattedReserves = (0, __aave_math_utils.formatReserves)({
 			reserves: reservesResponse.reservesData,
 			currentTimestamp,
 			marketReferenceCurrencyDecimals: reservesResponse.baseCurrencyData.marketReferenceCurrencyDecimals,
@@ -1257,10 +1267,14 @@ var UserSummary = class {
 			marketReferencePriceInUsd: reservesResponse.baseCurrencyData.marketReferenceCurrencyPriceInUsd,
 			marketReferenceCurrencyDecimals: reservesResponse.baseCurrencyData.marketReferenceCurrencyDecimals,
 			userReserves: userReservesResponse.userReserves,
-			formattedReserves,
+			formattedReserves: this.formattedReserves,
 			userEmodeCategoryId: userReservesResponse.userEmodeCategoryId
 		});
 	}
+	getReserveByUnderlyingAsset(tokenAddress) {
+		const normalizedTokenAddress = tokenAddress.toLowerCase();
+		return this.formattedReserves.find((reserve) => reserve.underlyingAsset.toLowerCase() === normalizedTokenAddress);
+	}
 	toHumanReadable() {
 		let output = "User Positions:\n";
 		output += `Total Liquidity (USD): ${formatNumeric(this.reserves.totalLiquidityUSD)}\n`;
@@ -1289,6 +1303,31 @@ var UserSummary = class {
 
 //#endregion
 //#region src/aave-lending-plugin/adapter.ts
+function hasVisibleReservePosition({ underlyingBalance, totalBorrows }) {
+	return underlyingBalance !== "0" || totalBorrows !== "0";
+}
+function toLendingReserveDetail(chainId, { reserve, underlyingBalance = "0", underlyingBalanceUSD = "0", variableBorrows = "0", variableBorrowsUSD = "0", totalBorrows = "0", totalBorrowsUSD = "0" }) {
+	return {
+		tokenUid: {
+			address: reserve.underlyingAsset,
+			chainId
+		},
+		...reserve.symbol !== void 0 ? { symbol: reserve.symbol } : {},
+		...reserve.name !== void 0 ? { name: reserve.name } : {},
+		...reserve.decimals !== void 0 ? { decimals: reserve.decimals } : {},
+		underlyingBalance,
+		underlyingBalanceUsd: underlyingBalanceUSD,
+		variableBorrows,
+		variableBorrowsUsd: variableBorrowsUSD,
+		totalBorrows,
+		totalBorrowsUsd: totalBorrowsUSD,
+		priceInUsd: reserve.priceInUSD,
+		priceInMarketReferenceCurrency: reserve.priceInMarketReferenceCurrency,
+		formattedPriceInMarketReferenceCurrency: reserve.formattedPriceInMarketReferenceCurrency,
+		availableLiquidity: reserve.availableLiquidity,
+		availableLiquidityUsd: reserve.availableLiquidityUSD
+	};
+}
 const AAVE_ETH_PLACEHOLDER = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
 /**
 * AAVEAdapter is the primary class wrapping Aave V3 interactions.
@@ -1392,22 +1431,18 @@ var AAVEAdapter = class {
 		return this.getPoolDataProvider().getReservesHumanized({ lendingPoolAddressProvider: this.market.POOL_ADDRESSES_PROVIDER });
 	}
 	async getUserSummary(params) {
-		const { totalLiquidityUSD, totalCollateralUSD, totalBorrowsUSD, netWorthUSD, availableBorrowsUSD, currentLoanToValue, currentLiquidationThreshold, healthFactor, userReservesData } = (await this._getUserSummary(params.walletAddress)).reserves;
-		const userReservesFormatted = [];
-		for (const { reserve, underlyingBalance, underlyingBalanceUSD, variableBorrows, variableBorrowsUSD, totalBorrows, totalBorrowsUSD: totalBorrowsUSD$1 } of userReservesData.filter((ur) => ur.underlyingBalanceUSD !== "0" || ur.totalBorrowsUSD !== "0")) userReservesFormatted.push({
-			tokenUid: {
-				address: reserve.underlyingAsset,
-				chainId: this.chain.id.toString()
-			},
-			underlyingBalance,
-			underlyingBalanceUsd: underlyingBalanceUSD,
-			variableBorrows,
-			variableBorrowsUsd: variableBorrowsUSD,
-			totalBorrows,
-			totalBorrowsUsd: totalBorrowsUSD$1
-		});
+		const userSummaryResponse = await this._getUserSummary(params.walletAddress);
+		const { totalLiquidityUSD, totalCollateralUSD, totalBorrowsUSD, netWorthUSD, availableBorrowsUSD, currentLoanToValue, currentLiquidationThreshold, healthFactor, userReservesData } = userSummaryResponse.reserves;
+		const chainId = this.chain.id.toString();
+		const userReservesFormatted = userReservesData.filter(hasVisibleReservePosition).map((reserve) => toLendingReserveDetail(chainId, reserve));
+		const requestedReserveAddress = params.tokenAddress ? params.tokenAddress.toLowerCase() : void 0;
 		return {
 			userReserves: userReservesFormatted,
+			requestedReserve: requestedReserveAddress ? userReservesFormatted.find(({ tokenUid }) => tokenUid.address.toLowerCase() === requestedReserveAddress) ?? (() => {
+				const reserve = userSummaryResponse.getReserveByUnderlyingAsset(requestedReserveAddress);
+				if (!reserve) return;
+				return toLendingReserveDetail(chainId, { reserve });
+			})() : void 0,
 			totalLiquidityUsd: totalLiquidityUSD,
 			totalCollateralUsd: totalCollateralUSD,
 			totalBorrowsUsd: totalBorrowsUSD,
@@ -1674,6 +1709,13 @@ var PublicEmberPluginRegistry = class {
 		return Array.from(this.lifecycleCapabilities.values());
 	}
 	/**
+	* Returns the lifecycle capability registered for a provider id, if present.
+	* @param providerId Provider/plugin id to look up.
+	*/
+	getLifecycleCapability(providerId) {
+		return this.lifecycleCapabilities.get(providerId);
+	}
+	/**
 	* Iterator for the registered Ember plugins.
 	*/
 	async *getPlugins() {

package/dist/index.d.cts

@@ -610,12 +610,20 @@ declare const LendTokenDetailSchema: z.ZodObject<{
     chainId: string;
     address: string;
   }>;
+  symbol: z.ZodOptional<z.ZodString>;
+  name: z.ZodOptional<z.ZodString>;
+  decimals: z.ZodOptional<z.ZodNumber>;
   underlyingBalance: z.ZodString;
   underlyingBalanceUsd: z.ZodString;
   variableBorrows: z.ZodString;
   variableBorrowsUsd: z.ZodString;
   totalBorrows: z.ZodString;
   totalBorrowsUsd: z.ZodString;
+  priceInUsd: z.ZodString;
+  priceInMarketReferenceCurrency: z.ZodString;
+  formattedPriceInMarketReferenceCurrency: z.ZodString;
+  availableLiquidity: z.ZodString;
+  availableLiquidityUsd: z.ZodString;
 }, "strip", z.ZodTypeAny, {
   tokenUid: {
     chainId: string;
@@ -627,6 +635,14 @@ declare const LendTokenDetailSchema: z.ZodObject<{
   variableBorrowsUsd: string;
   totalBorrows: string;
   totalBorrowsUsd: string;
+  priceInUsd: string;
+  priceInMarketReferenceCurrency: string;
+  formattedPriceInMarketReferenceCurrency: string;
+  availableLiquidity: string;
+  availableLiquidityUsd: string;
+  symbol?: string | undefined;
+  name?: string | undefined;
+  decimals?: number | undefined;
 }, {
   tokenUid: {
     chainId: string;
@@ -638,6 +654,14 @@ declare const LendTokenDetailSchema: z.ZodObject<{
   variableBorrowsUsd: string;
   totalBorrows: string;
   totalBorrowsUsd: string;
+  priceInUsd: string;
+  priceInMarketReferenceCurrency: string;
+  formattedPriceInMarketReferenceCurrency: string;
+  availableLiquidity: string;
+  availableLiquidityUsd: string;
+  symbol?: string | undefined;
+  name?: string | undefined;
+  decimals?: number | undefined;
 }>;
 type LendTokenDetail = z.infer<typeof LendTokenDetailSchema>;
 declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
@@ -652,12 +676,20 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
       chainId: string;
       address: string;
     }>;
+    symbol: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
     underlyingBalance: z.ZodString;
     underlyingBalanceUsd: z.ZodString;
     variableBorrows: z.ZodString;
     variableBorrowsUsd: z.ZodString;
     totalBorrows: z.ZodString;
     totalBorrowsUsd: z.ZodString;
+    priceInUsd: z.ZodString;
+    priceInMarketReferenceCurrency: z.ZodString;
+    formattedPriceInMarketReferenceCurrency: z.ZodString;
+    availableLiquidity: z.ZodString;
+    availableLiquidityUsd: z.ZodString;
   }, "strip", z.ZodTypeAny, {
     tokenUid: {
       chainId: string;
@@ -669,6 +701,14 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
     variableBorrowsUsd: string;
     totalBorrows: string;
     totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
   }, {
     tokenUid: {
       chainId: string;
@@ -680,7 +720,79 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
     variableBorrowsUsd: string;
     totalBorrows: string;
     totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
   }>, "many">;
+  requestedReserve: z.ZodOptional<z.ZodObject<{
+    tokenUid: z.ZodObject<{
+      chainId: z.ZodString;
+      address: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+      chainId: string;
+      address: string;
+    }, {
+      chainId: string;
+      address: string;
+    }>;
+    symbol: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    decimals: z.ZodOptional<z.ZodNumber>;
+    underlyingBalance: z.ZodString;
+    underlyingBalanceUsd: z.ZodString;
+    variableBorrows: z.ZodString;
+    variableBorrowsUsd: z.ZodString;
+    totalBorrows: z.ZodString;
+    totalBorrowsUsd: z.ZodString;
+    priceInUsd: z.ZodString;
+    priceInMarketReferenceCurrency: z.ZodString;
+    formattedPriceInMarketReferenceCurrency: z.ZodString;
+    availableLiquidity: z.ZodString;
+    availableLiquidityUsd: z.ZodString;
+  }, "strip", z.ZodTypeAny, {
+    tokenUid: {
+      chainId: string;
+      address: string;
+    };
+    underlyingBalance: string;
+    underlyingBalanceUsd: string;
+    variableBorrows: string;
+    variableBorrowsUsd: string;
+    totalBorrows: string;
+    totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
+  }, {
+    tokenUid: {
+      chainId: string;
+      address: string;
+    };
+    underlyingBalance: string;
+    underlyingBalanceUsd: string;
+    variableBorrows: string;
+    variableBorrowsUsd: string;
+    totalBorrows: string;
+    totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
+  }>>;
   totalLiquidityUsd: z.ZodString;
   totalCollateralUsd: z.ZodString;
   totalBorrowsUsd: z.ZodString;
@@ -702,6 +814,14 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
     variableBorrowsUsd: string;
     totalBorrows: string;
     totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
   }[];
   totalLiquidityUsd: string;
   totalCollateralUsd: string;
@@ -710,6 +830,26 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
   currentLoanToValue: string;
   currentLiquidationThreshold: string;
   healthFactor: string;
+  requestedReserve?: {
+    tokenUid: {
+      chainId: string;
+      address: string;
+    };
+    underlyingBalance: string;
+    underlyingBalanceUsd: string;
+    variableBorrows: string;
+    variableBorrowsUsd: string;
+    totalBorrows: string;
+    totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
+  } | undefined;
 }, {
   totalBorrowsUsd: string;
   userReserves: {
@@ -723,6 +863,14 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
     variableBorrowsUsd: string;
     totalBorrows: string;
     totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
   }[];
   totalLiquidityUsd: string;
   totalCollateralUsd: string;
@@ -731,6 +879,26 @@ declare const GetWalletLendingPositionsResponseSchema: z.ZodObject<{
   currentLoanToValue: string;
   currentLiquidationThreshold: string;
   healthFactor: string;
+  requestedReserve?: {
+    tokenUid: {
+      chainId: string;
+      address: string;
+    };
+    underlyingBalance: string;
+    underlyingBalanceUsd: string;
+    variableBorrows: string;
+    variableBorrowsUsd: string;
+    totalBorrows: string;
+    totalBorrowsUsd: string;
+    priceInUsd: string;
+    priceInMarketReferenceCurrency: string;
+    formattedPriceInMarketReferenceCurrency: string;
+    availableLiquidity: string;
+    availableLiquidityUsd: string;
+    symbol?: string | undefined;
+    name?: string | undefined;
+    decimals?: number | undefined;
+  } | undefined;
 }>;
 type GetWalletLendingPositionsResponse = z.infer<typeof GetWalletLendingPositionsResponseSchema>;
 //#endregion
@@ -6517,6 +6685,11 @@ declare class PublicEmberPluginRegistry {
    * Returns all lifecycle capabilities registered in the registry.
    */
   getLifecycleCapabilities(): LifecycleCapability[];
+  /**
+   * Returns the lifecycle capability registered for a provider id, if present.
+   * @param providerId Provider/plugin id to look up.
+   */
+  getLifecycleCapability(providerId: string): LifecycleCapability | undefined;
   /**
    * Iterator for the registered Ember plugins.
    */