@morpho-org/blue-sdk 2.0.0-next.11 → 2.0.0-next.12

package/lib/errors.d.ts

@@ -35,6 +35,10 @@ export declare namespace BlueErrors {
         readonly marketId: MarketId;
         constructor(marketId: MarketId);
     }
+    class UnknownOraclePrice extends Error {
+        readonly marketId: MarketId;
+        constructor(marketId: MarketId);
+    }
     class InsufficientPosition extends Error {
         readonly user: Address;
         readonly marketId: MarketId;

package/lib/errors.js

@@ -63,6 +63,14 @@ export var BlueErrors;
         }
     }
     BlueErrors.InsufficientLiquidity = InsufficientLiquidity;
+    class UnknownOraclePrice extends Error {
+        marketId;
+        constructor(marketId) {
+            super(`unknown oracle price of market "${marketId}"`);
+            this.marketId = marketId;
+        }
+    }
+    BlueErrors.UnknownOraclePrice = UnknownOraclePrice;
     class InsufficientPosition extends Error {
         user;
         marketId;

package/lib/market/Market.d.ts

@@ -21,10 +21,10 @@ export interface MaxWithdrawCollateralOptions {
 export interface MaxPositionCapacities {
     supply: CapacityLimit;
     withdraw: CapacityLimit;
-    borrow: CapacityLimit;
+    borrow: CapacityLimit | undefined;
     repay: CapacityLimit;
     supplyCollateral: CapacityLimit;
-    withdrawCollateral: CapacityLimit;
+    withdrawCollateral: CapacityLimit | undefined;
 }
 export interface InputMarket {
     params: MarketParams;
@@ -34,7 +34,7 @@ export interface InputMarket {
     totalBorrowShares: bigint;
     lastUpdate: bigint;
     fee: bigint;
-    price: bigint;
+    price?: bigint;
     rateAtTarget?: bigint;
 }
 /**
@@ -71,8 +71,9 @@ export declare class Market implements InputMarket {
     fee: bigint;
     /**
      * The price as returned by the market's oracle.
+     * `undefined` if the oracle is undefined or reverts.
      */
-    price: bigint;
+    price?: bigint;
     /**
      * If the market uses the Adaptive Curve IRM, the rate at target utilization.
      * Undefined otherwise.
@@ -189,57 +190,65 @@ export declare class Market implements InputMarket {
     getRepayToUtilization(utilization: bigint): bigint;
     /**
      * Returns the value of a given amount of collateral quoted in loan assets.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param collateral The amount of collateral to quote.
      */
-    getCollateralValue(collateral: bigint): bigint;
+    getCollateralValue(collateral: bigint): bigint | undefined;
     /**
      * Returns the maximum debt allowed given a certain amount of collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * To calculate the amount of loan assets that can be borrowed, use `getMaxBorrowableAssets`.
      * @param collateral The amount of collateral to consider.
      */
-    getMaxBorrowAssets(collateral: bigint, { maxLtv }?: MaxBorrowOptions): bigint;
+    getMaxBorrowAssets(collateral: bigint, { maxLtv }?: MaxBorrowOptions): bigint | undefined;
     /**
      * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getMaxBorrowableAssets(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint;
+    }): bigint | undefined;
     /**
      * Returns the amount of collateral that would be seized in a liquidation given a certain amount of repaid shares.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param repaidShares The amount of shares hypothetically repaid.
      */
-    getLiquidationSeizedAssets(repaidShares: bigint): bigint;
+    getLiquidationSeizedAssets(repaidShares: bigint): bigint | undefined;
     /**
      * Returns the amount of borrow shares that would be repaid in a liquidation given a certain amount of seized collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param seizedAssets The amount of collateral hypothetically seized.
      */
-    getLiquidationRepaidShares(seizedAssets: bigint): bigint;
+    getLiquidationRepaidShares(seizedAssets: bigint): bigint | undefined;
     /**
      * Returns the maximum amount of collateral that is worth being seized in a liquidation given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getSeizableCollateral(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint;
+    }): bigint | undefined;
     /**
      * Returns the amount of collateral that can be withdrawn given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getWithdrawableCollateral(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }, { maxLtv }?: MaxWithdrawCollateralOptions): bigint;
+    }, { maxLtv }?: MaxWithdrawCollateralOptions): bigint | undefined;
     /**
      * Returns whether a given borrow position is healthy.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to check.
      */
     isHealthy(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): boolean;
+    }): boolean | undefined;
     /**
      * Returns the liquidation price of a given borrow position.
      * @param position The borrow position to consider.
@@ -251,13 +260,14 @@ export declare class Market implements InputMarket {
     /**
      * Returns the price variation required for the given position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
+     * Returns `undefined` iff the market's price is undefined.
      * Returns null if the position is not a borrow.
      * @param position The borrow position to consider.
      */
     getPriceVariationToLiquidationPrice(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint | null;
+    }): bigint | null | undefined;
     /**
      * Returns the health factor of a given borrow position (scaled by WAD).
      * @param position The borrow position to consider.
@@ -265,7 +275,7 @@ export declare class Market implements InputMarket {
     getHealthFactor(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint | null;
+    }): bigint | null | undefined;
     /**
      * Returns the loan-to-value ratio of a given borrow position (scaled by WAD).
      * @param position The borrow position to consider.
@@ -273,7 +283,7 @@ export declare class Market implements InputMarket {
     getLtv(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint | null;
+    }): bigint | null | undefined;
     /**
      * Returns the usage ratio of the maximum borrow capacity given a certain borrow position (scaled by WAD).
      * @param position The borrow position to consider.
@@ -281,16 +291,17 @@ export declare class Market implements InputMarket {
     getBorrowCapacityUsage(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }): bigint | null;
+    }): bigint | undefined;
     /**
      * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position
      * and the reason for the limit.
+     * Returns `undefined` iff the market's price is undefined.
      * @param position The borrow position to consider.
      */
     getBorrowCapacityLimit({ collateral, borrowShares, }: {
         collateral: bigint;
         borrowShares?: bigint;
-    }, options?: MaxBorrowOptions): CapacityLimit;
+    }, options?: MaxBorrowOptions): CapacityLimit | undefined;
     /**
      * Returns the maximum amount of loan assets that can be repaid given a certain borrow position
      * and a balance of loan assets, and the reason for the limit.
@@ -308,12 +319,13 @@ export declare class Market implements InputMarket {
     /**
      * Returns the maximum amount of collateral assets that can be withdrawn given a certain borrow position
      * and the reason for the limit.
+     * Returns `undefined` iff the market's price is undefined.
      * @param position The borrow position to consider.
      */
     getWithdrawCollateralCapacityLimit(position: {
         collateral: bigint;
         borrowShares: bigint;
-    }, options?: MaxWithdrawCollateralOptions): CapacityLimit;
+    }, options?: MaxWithdrawCollateralOptions): CapacityLimit | undefined;
     /**
      * Returns the maximum capacity for all interactions with Morpho Blue given a certain position
      * and loan and collateral balances.

package/lib/market/Market.js

@@ -44,6 +44,7 @@ export class Market {
     fee;
     /**
      * The price as returned by the market's oracle.
+     * `undefined` if the oracle is undefined or reverts.
      */
     price;
     /**
@@ -266,6 +267,7 @@ export class Market {
     }
     /**
      * Returns the value of a given amount of collateral quoted in loan assets.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param collateral The amount of collateral to quote.
      */
     getCollateralValue(collateral) {
@@ -273,6 +275,7 @@ export class Market {
     }
     /**
      * Returns the maximum debt allowed given a certain amount of collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * To calculate the amount of loan assets that can be borrowed, use `getMaxBorrowableAssets`.
      * @param collateral The amount of collateral to consider.
      */
@@ -283,6 +286,7 @@ export class Market {
     }
     /**
      * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getMaxBorrowableAssets(position) {
@@ -290,6 +294,7 @@ export class Market {
     }
     /**
      * Returns the amount of collateral that would be seized in a liquidation given a certain amount of repaid shares.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param repaidShares The amount of shares hypothetically repaid.
      */
     getLiquidationSeizedAssets(repaidShares) {
@@ -297,6 +302,7 @@ export class Market {
     }
     /**
      * Returns the amount of borrow shares that would be repaid in a liquidation given a certain amount of seized collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param seizedAssets The amount of collateral hypothetically seized.
      */
     getLiquidationRepaidShares(seizedAssets) {
@@ -304,6 +310,7 @@ export class Market {
     }
     /**
      * Returns the maximum amount of collateral that is worth being seized in a liquidation given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getSeizableCollateral(position) {
@@ -311,6 +318,7 @@ export class Market {
     }
     /**
      * Returns the amount of collateral that can be withdrawn given a certain borrow position.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to consider.
      */
     getWithdrawableCollateral(position, { maxLtv = this.params.lltv } = {}) {
@@ -320,6 +328,7 @@ export class Market {
     }
     /**
      * Returns whether a given borrow position is healthy.
+     * `undefined` iff the market's oracle is undefined or reverts.
      * @param position The borrow position to check.
      */
     isHealthy(position) {
@@ -335,6 +344,7 @@ export class Market {
     /**
      * Returns the price variation required for the given position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
+     * Returns `undefined` iff the market's price is undefined.
      * Returns null if the position is not a borrow.
      * @param position The borrow position to consider.
      */
@@ -365,11 +375,15 @@ export class Market {
     /**
      * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position
      * and the reason for the limit.
+     * Returns `undefined` iff the market's price is undefined.
      * @param position The borrow position to consider.
      */
     getBorrowCapacityLimit({ collateral, borrowShares = 0n, }, options) {
+        const maxBorrowAssets = this.getMaxBorrowAssets(collateral, options);
+        if (maxBorrowAssets == null)
+            return;
         // handle edge cases when the user is liquidatable (maxBorrow < borrow)
-        const maxBorrowableAssets = MathLib.zeroFloorSub(this.getMaxBorrowAssets(collateral, options), this.toBorrowAssets(borrowShares));
+        const maxBorrowableAssets = MathLib.zeroFloorSub(maxBorrowAssets, this.toBorrowAssets(borrowShares));
         const { liquidity } = this;
         if (maxBorrowableAssets > liquidity)
             return {
@@ -419,10 +433,13 @@ export class Market {
     /**
      * Returns the maximum amount of collateral assets that can be withdrawn given a certain borrow position
      * and the reason for the limit.
+     * Returns `undefined` iff the market's price is undefined.
      * @param position The borrow position to consider.
      */
     getWithdrawCollateralCapacityLimit(position, options) {
         const withdrawableCollateral = this.getWithdrawableCollateral(position, options);
+        if (withdrawableCollateral == null)
+            return;
         if (position.collateral > withdrawableCollateral)
             return {
                 value: withdrawableCollateral,

package/lib/market/MarketUtils.d.ts

@@ -95,68 +95,102 @@ export declare namespace MarketUtils {
     function getCollateralPower(collateral: BigIntish, { lltv }: {
         lltv: BigIntish;
     }): bigint;
+    /**
+     * Returns the value of a given amount of collateral quoted in loan assets.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getCollateralValue(collateral: BigIntish, { price }: {
-        price: BigIntish;
-    }): bigint;
+        price?: BigIntish;
+    }): bigint | undefined;
+    /**
+     * Returns the maximum debt allowed given a certain amount of collateral.
+     * Return `undefined` iff the market's price is undefined.
+     * To calculate the amount of loan assets that can be borrowed, use `getMaxBorrowableAssets`.
+     */
     function getMaxBorrowAssets(collateral: BigIntish, market: {
-        price: BigIntish;
+        price?: BigIntish;
     }, { lltv }: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getMaxBorrowableAssets({ collateral, borrowShares, }: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, marketParams: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns the amount of collateral that would be seized in a liquidation given a certain amount of repaid shares.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getLiquidationSeizedAssets(repaidShares: BigIntish, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, config: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns the amount of borrow shares that would be repaid in a liquidation given a certain amount of seized collateral.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getLiquidationRepaidShares(seizedAssets: BigIntish, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, config: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns the maximum amount of collateral that is worth being seized in a liquidation given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getSeizableCollateral(position: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, config: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns the amount of collateral that can be withdrawn given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getWithdrawableCollateral({ collateral, borrowShares, }: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, { lltv }: {
         lltv: BigIntish;
-    }): bigint;
+    }): bigint | undefined;
+    /**
+     * Returns whether a given borrow position is healthy.
+     * Return `undefined` iff the market's price is undefined.
+     * @param position The borrow position to check.
+     */
     function isHealthy({ collateral, borrowShares, }: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, marketParams: {
         lltv: BigIntish;
-    }): boolean;
+    }): boolean | undefined;
     /**
      * Returns the price of the collateral quoted in the loan token (e.g. ETH/DAI)
      * that set the user's position to be liquidatable.
@@ -174,6 +208,7 @@ export declare namespace MarketUtils {
     /**
      * Returns the price variation required for the given position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
+     * Returns `undefined` iff the market's price is undefined.
      * Returns null if the position is not a borrow.
      */
     function getPriceVariationToLiquidationPrice(position: {
@@ -182,38 +217,52 @@ export declare namespace MarketUtils {
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, marketParams: {
         lltv: BigIntish;
-    }): bigint | null;
+    }): bigint | null | undefined;
+    /**
+     * Returns the health factor of a given borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     * Returns null if the position is not a borrow.
+     */
     function getHealthFactor({ collateral, borrowShares, }: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, marketParams: {
         lltv: BigIntish;
-    }): bigint | null;
+    }): bigint | null | undefined;
+    /**
+     * Returns the loan-to-value ratio of a given borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     * Returns null if the position is not a borrow.
+     */
     function getLtv({ collateral, borrowShares, }: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
-    }): bigint | null;
+        price?: BigIntish;
+    }): bigint | null | undefined;
+    /**
+     * Returns the usage ratio of the maximum borrow capacity given a certain borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     */
     function getBorrowCapacityUsage(position: {
         collateral: BigIntish;
         borrowShares: BigIntish;
     }, market: {
         totalBorrowAssets: BigIntish;
         totalBorrowShares: BigIntish;
-        price: BigIntish;
+        price?: BigIntish;
     }, marketParams: {
         lltv: BigIntish;
-    }): bigint | null;
+    }): bigint | undefined;
     function toSupplyAssets(shares: BigIntish, market: {
         totalSupplyAssets: BigIntish;
         totalSupplyShares: BigIntish;

package/lib/market/MarketUtils.js

@@ -132,46 +132,98 @@ export var MarketUtils;
         return MathLib.wMulDown(collateral, lltv);
     }
     MarketUtils.getCollateralPower = getCollateralPower;
+    /**
+     * Returns the value of a given amount of collateral quoted in loan assets.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getCollateralValue(collateral, { price }) {
+        if (price == null)
+            return;
         return MathLib.mulDivDown(collateral, price, ORACLE_PRICE_SCALE);
     }
     MarketUtils.getCollateralValue = getCollateralValue;
+    /**
+     * Returns the maximum debt allowed given a certain amount of collateral.
+     * Return `undefined` iff the market's price is undefined.
+     * To calculate the amount of loan assets that can be borrowed, use `getMaxBorrowableAssets`.
+     */
     function getMaxBorrowAssets(collateral, market, { lltv }) {
-        return MathLib.wMulDown(getCollateralValue(collateral, market), lltv);
+        const collateralValue = getCollateralValue(collateral, market);
+        if (collateralValue == null)
+            return;
+        return MathLib.wMulDown(collateralValue, lltv);
     }
     MarketUtils.getMaxBorrowAssets = getMaxBorrowAssets;
+    /**
+     * Returns the maximum amount of loan assets that can be borrowed given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getMaxBorrowableAssets({ collateral, borrowShares, }, market, marketParams) {
-        return MathLib.zeroFloorSub(getMaxBorrowAssets(collateral, market, marketParams), toBorrowAssets(borrowShares, market));
+        const maxBorrowAssets = getMaxBorrowAssets(collateral, market, marketParams);
+        if (maxBorrowAssets == null)
+            return;
+        return MathLib.zeroFloorSub(maxBorrowAssets, toBorrowAssets(borrowShares, market));
     }
     MarketUtils.getMaxBorrowableAssets = getMaxBorrowableAssets;
+    /**
+     * Returns the amount of collateral that would be seized in a liquidation given a certain amount of repaid shares.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getLiquidationSeizedAssets(repaidShares, market, config) {
+        if (market.price == null)
+            return;
         market.price = BigInt(market.price);
         if (market.price === 0n)
             return 0n;
         return MathLib.mulDivDown(MathLib.wMulDown(toBorrowAssets(repaidShares, market, "Down"), getLiquidationIncentiveFactor(config)), ORACLE_PRICE_SCALE, market.price);
     }
     MarketUtils.getLiquidationSeizedAssets = getLiquidationSeizedAssets;
+    /**
+     * Returns the amount of borrow shares that would be repaid in a liquidation given a certain amount of seized collateral.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getLiquidationRepaidShares(seizedAssets, market, config) {
+        if (market.price == null)
+            return;
         return toBorrowShares(MathLib.wDivUp(MathLib.mulDivUp(seizedAssets, market.price, ORACLE_PRICE_SCALE), getLiquidationIncentiveFactor(config)), market, "Up");
     }
     MarketUtils.getLiquidationRepaidShares = getLiquidationRepaidShares;
+    /**
+     * Returns the maximum amount of collateral that is worth being seized in a liquidation given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getSeizableCollateral(position, market, config) {
+        if (market.price == null)
+            return; // Must be checked before calling `isHealthy`.
         market.price = BigInt(market.price);
         if (market.price === 0n || isHealthy(position, market, config))
             return 0n;
         return MathLib.min(position.collateral, getLiquidationSeizedAssets(position.borrowShares, market, config));
     }
     MarketUtils.getSeizableCollateral = getSeizableCollateral;
+    /**
+     * Returns the amount of collateral that can be withdrawn given a certain borrow position.
+     * Return `undefined` iff the market's price is undefined.
+     */
     function getWithdrawableCollateral({ collateral, borrowShares, }, market, { lltv }) {
+        if (market.price == null)
+            return;
         market.price = BigInt(market.price);
         if (market.price === 0n)
             return 0n;
         return MathLib.zeroFloorSub(collateral, MathLib.wDivUp(MathLib.mulDivUp(toBorrowAssets(borrowShares, market), ORACLE_PRICE_SCALE, market.price), lltv));
     }
     MarketUtils.getWithdrawableCollateral = getWithdrawableCollateral;
+    /**
+     * Returns whether a given borrow position is healthy.
+     * Return `undefined` iff the market's price is undefined.
+     * @param position The borrow position to check.
+     */
     function isHealthy({ collateral, borrowShares, }, market, marketParams) {
-        return (getMaxBorrowAssets(collateral, market, marketParams) >=
-            toBorrowAssets(borrowShares, market));
+        const maxBorrowAssets = getMaxBorrowAssets(collateral, market, marketParams);
+        if (maxBorrowAssets == null)
+            return;
+        return maxBorrowAssets >= toBorrowAssets(borrowShares, market);
     }
     MarketUtils.isHealthy = isHealthy;
     /**
@@ -194,9 +246,12 @@ export var MarketUtils;
     /**
      * Returns the price variation required for the given position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
+     * Returns `undefined` iff the market's price is undefined.
      * Returns null if the position is not a borrow.
      */
     function getPriceVariationToLiquidationPrice(position, market, marketParams) {
+        if (market.price == null)
+            return;
         market.price = BigInt(market.price);
         if (market.price === 0n)
             return null;
@@ -206,6 +261,11 @@ export var MarketUtils;
         return MathLib.wDivUp(liquidationPrice, market.price) - MathLib.WAD;
     }
     MarketUtils.getPriceVariationToLiquidationPrice = getPriceVariationToLiquidationPrice;
+    /**
+     * Returns the health factor of a given borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     * Returns null if the position is not a borrow.
+     */
     function getHealthFactor({ collateral, borrowShares, }, market, marketParams) {
         borrowShares = BigInt(borrowShares);
         market.totalBorrowShares = BigInt(market.totalBorrowShares);
@@ -215,24 +275,39 @@ export var MarketUtils;
         if (borrowAssets === 0n)
             return MathLib.MAX_UINT_256;
         const maxBorrowAssets = getMaxBorrowAssets(collateral, market, marketParams);
+        if (maxBorrowAssets == null)
+            return;
         return MathLib.wDivDown(maxBorrowAssets, borrowAssets);
     }
     MarketUtils.getHealthFactor = getHealthFactor;
+    /**
+     * Returns the loan-to-value ratio of a given borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     * Returns null if the position is not a borrow.
+     */
     function getLtv({ collateral, borrowShares, }, market) {
         borrowShares = BigInt(borrowShares);
         market.totalBorrowShares = BigInt(market.totalBorrowShares);
         if (borrowShares === 0n || market.totalBorrowShares === 0n)
             return null;
         const collateralValue = getCollateralValue(collateral, market);
+        if (collateralValue == null)
+            return;
         if (collateralValue === 0n)
             return MathLib.MAX_UINT_256;
         return MathLib.wDivUp(toBorrowAssets(borrowShares, market), collateralValue);
     }
     MarketUtils.getLtv = getLtv;
+    /**
+     * Returns the usage ratio of the maximum borrow capacity given a certain borrow position (scaled by WAD).
+     * Returns `undefined` iff the market's price is undefined.
+     */
     function getBorrowCapacityUsage(position, market, marketParams) {
         const hf = getHealthFactor(position, market, marketParams);
+        if (hf === undefined)
+            return;
         if (hf === null)
-            return null;
+            return 0n;
         if (hf === 0n)
             return MathLib.MAX_UINT_256;
         return MathLib.wDivUp(MathLib.WAD, hf);

package/lib/position/Position.d.ts

@@ -42,28 +42,34 @@ export declare class AccrualPosition extends Position implements InputAccrualPos
     get borrowAssets(): bigint;
     /**
      * The value of this position's collateral quoted in loan assets.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get collateralValue(): bigint;
+    get collateralValue(): bigint | undefined;
     /**
      * The maximum amount of loan assets that can be borrowed against this position's collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get maxBorrowAssets(): bigint;
+    get maxBorrowAssets(): bigint | undefined;
     /**
      * The maximum additional amount of assets that can be borrowed against this position's collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get maxBorrowableAssets(): bigint;
+    get maxBorrowableAssets(): bigint | undefined;
     /**
      * The maximum amount of collateral that can be seized in exchange for the outstanding debt.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get seizableCollateral(): bigint;
+    get seizableCollateral(): bigint | undefined;
     /**
      * The maximum amount of collateral that can be withdrawn.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get withdrawableCollateral(): bigint;
+    get withdrawableCollateral(): bigint | undefined;
     /**
      * Whether this position is healthy.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get isHealthy(): boolean;
+    get isHealthy(): boolean | undefined;
     /**
      * The price of the collateral quoted in loan assets that would allow this position to be liquidated.
      */
@@ -71,27 +77,30 @@ export declare class AccrualPosition extends Position implements InputAccrualPos
     /**
      * The price variation required for the position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
-     * Returns null if the position is not a borrow.
+     * `undefined` iff the market's oracle is undefined or reverts.
+     * Null if the position is not a borrow.
      */
-    get priceVariationToLiquidationPrice(): bigint | null;
+    get priceVariationToLiquidationPrice(): bigint | null | undefined;
     /**
      * This position's Loan-To-Value (debt over collateral power, scaled by WAD).
      * If the collateral price is 0, LTV is `MaxUint256`.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get ltv(): bigint | null;
+    get ltv(): bigint | null | undefined;
     /**
      * This position's health factor (collateral power over debt, scaled by WAD).
      * If the debt is 0, health factor is `MaxUint256`.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
-    get healthFactor(): bigint | null;
+    get healthFactor(): bigint | null | undefined;
     /**
      * The percentage of this position's borrow power currently used (scaled by WAD).
      * If the collateral price is 0, usage is `MaxUint256`.
      */
-    get borrowCapacityUsage(): bigint | null;
-    get borrowCapacityLimit(): import("../market/Market.js").CapacityLimit;
+    get borrowCapacityUsage(): bigint | undefined;
+    get borrowCapacityLimit(): import("../market/Market.js").CapacityLimit | undefined;
     get withdrawCapacityLimit(): import("../market/Market.js").CapacityLimit;
-    get withdrawCollateralCapacityLimit(): import("../market/Market.js").CapacityLimit;
+    get withdrawCollateralCapacityLimit(): import("../market/Market.js").CapacityLimit | undefined;
     /**
      * Returns a new position derived from this position, whose interest has been accrued up to the given timestamp.
      * @param timestamp The timestamp at which to accrue interest. Must be greater than or equal to the market's `lastUpdate`.

package/lib/position/Position.js

@@ -46,36 +46,42 @@ export class AccrualPosition extends Position {
     }
     /**
      * The value of this position's collateral quoted in loan assets.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get collateralValue() {
         return this.market.getCollateralValue(this.collateral);
     }
     /**
      * The maximum amount of loan assets that can be borrowed against this position's collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get maxBorrowAssets() {
         return this.market.getMaxBorrowAssets(this.collateral);
     }
     /**
      * The maximum additional amount of assets that can be borrowed against this position's collateral.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get maxBorrowableAssets() {
         return this.market.getMaxBorrowableAssets(this);
     }
     /**
      * The maximum amount of collateral that can be seized in exchange for the outstanding debt.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get seizableCollateral() {
         return this.market.getSeizableCollateral(this);
     }
     /**
      * The maximum amount of collateral that can be withdrawn.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get withdrawableCollateral() {
         return this.market.getWithdrawableCollateral(this);
     }
     /**
      * Whether this position is healthy.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get isHealthy() {
         return this.market.isHealthy(this);
@@ -89,7 +95,8 @@ export class AccrualPosition extends Position {
     /**
      * The price variation required for the position to reach its liquidation threshold (scaled by WAD).
      * Negative when healthy (the price needs to drop x%), positive when unhealthy (the price needs to soar x%).
-     * Returns null if the position is not a borrow.
+     * `undefined` iff the market's oracle is undefined or reverts.
+     * Null if the position is not a borrow.
      */
     get priceVariationToLiquidationPrice() {
         return this.market.getPriceVariationToLiquidationPrice(this);
@@ -97,6 +104,7 @@ export class AccrualPosition extends Position {
     /**
      * This position's Loan-To-Value (debt over collateral power, scaled by WAD).
      * If the collateral price is 0, LTV is `MaxUint256`.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get ltv() {
         return this.market.getLtv(this);
@@ -104,6 +112,7 @@ export class AccrualPosition extends Position {
     /**
      * This position's health factor (collateral power over debt, scaled by WAD).
      * If the debt is 0, health factor is `MaxUint256`.
+     * `undefined` iff the market's oracle is undefined or reverts.
      */
     get healthFactor() {
         return this.market.getHealthFactor(this);
@@ -134,61 +143,53 @@ export class AccrualPosition extends Position {
     supply(assets, shares, timestamp) {
         let { market } = this;
         ({ market, assets, shares } = market.supply(assets, shares, timestamp));
-        this.supplyShares += shares;
-        return {
-            position: new AccrualPosition(this, market),
-            assets,
-            shares,
-        };
+        const position = new AccrualPosition(this, market);
+        position.supplyShares += shares;
+        return { position, assets, shares };
     }
     withdraw(assets, shares, timestamp) {
         let { market } = this;
         ({ market, assets, shares } = market.withdraw(assets, shares, timestamp));
-        this.supplyShares -= shares;
-        if (this.supplyShares < 0n)
-            throw new BlueErrors.InsufficientPosition(this.user, this.marketId);
-        return {
-            position: new AccrualPosition(this, market),
-            assets,
-            shares,
-        };
+        const position = new AccrualPosition(this, market);
+        position.supplyShares -= shares;
+        if (position.supplyShares < 0n)
+            throw new BlueErrors.InsufficientPosition(position.user, position.marketId);
+        return { position, assets, shares };
     }
     supplyCollateral(assets) {
         this.collateral += assets;
         return new AccrualPosition(this, new Market(this.market));
     }
     withdrawCollateral(assets, timestamp) {
-        const market = this.market.accrueInterest(timestamp);
-        this.collateral -= assets;
-        if (this.collateral < 0n)
-            throw new BlueErrors.InsufficientPosition(this.user, this.marketId);
-        if (!market.isHealthy(this))
-            throw new BlueErrors.InsufficientCollateral(this.user, this.marketId);
-        return new AccrualPosition(this, market);
+        if (this.market.price == null)
+            throw new BlueErrors.UnknownOraclePrice(this.marketId);
+        const position = this.accrueInterest(timestamp);
+        position.collateral -= assets;
+        if (position.collateral < 0n)
+            throw new BlueErrors.InsufficientPosition(position.user, position.marketId);
+        if (!position.isHealthy)
+            throw new BlueErrors.InsufficientCollateral(position.user, position.marketId);
+        return position;
     }
     borrow(assets, shares, timestamp) {
         let { market } = this;
+        if (market.price == null)
+            throw new BlueErrors.UnknownOraclePrice(market.id);
         ({ market, assets, shares } = market.borrow(assets, shares, timestamp));
-        this.borrowShares += shares;
-        if (!market.isHealthy(this))
+        const position = new AccrualPosition(this, market);
+        position.borrowShares += shares;
+        if (!position.isHealthy)
             throw new BlueErrors.InsufficientCollateral(this.user, this.marketId);
-        return {
-            position: new AccrualPosition(this, market),
-            assets,
-            shares,
-        };
+        return { position, assets, shares };
     }
     repay(assets, shares, timestamp) {
         let { market } = this;
         ({ market, assets, shares } = market.repay(assets, shares, timestamp));
-        this.borrowShares -= shares;
-        if (this.borrowShares < 0n)
-            throw new BlueErrors.InsufficientPosition(this.user, this.marketId);
-        return {
-            position: new AccrualPosition(this, market),
-            assets,
-            shares,
-        };
+        const position = new AccrualPosition(this, market);
+        position.borrowShares -= shares;
+        if (position.borrowShares < 0n)
+            throw new BlueErrors.InsufficientPosition(position.user, position.marketId);
+        return { position, assets, shares };
     }
     getRepayCapacityLimit(loanTokenBalance) {
         return this.market.getRepayCapacityLimit(this.borrowShares, loanTokenBalance);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morpho-org/blue-sdk",
   "description": "Framework-agnostic package that defines Morpho-related entity classes (such as `Market`, `Token`, `Vault`).",
-  "version": "2.0.0-next.11",
+  "version": "2.0.0-next.12",
   "author": "Morpho Association <contact@morpho.org>",
   "contributors": [
     "Rubilmax <rmilon@gmail.com>"