@suilend/sdk 13.7.0-next.ge2ee95d → 13.8.0-next.gbe76414

package/_generated/suilend/reserve-config/functions.d.ts

@@ -457,6 +457,25 @@ export interface SetConfidenceMultiplierBuilderArgs {
 export declare function setConfidenceMultiplierBuilder(tx: Transaction, args: SetConfidenceMultiplierBuilderArgs, options?: {
     env?: EnvConfig;
 }): TransactionResult;
+export interface SetMinConfidenceRatioBuilderArgs {
+    builder: TransactionObjectInput;
+    minConfidenceRatio: bigint | TransactionArgument;
+}
+/**
+ * Seeded by `from` like the confidence multiplier. Must be non-zero, and must stay
+ * above the confidence multiplier `k` (see `build`).
+ */
+export declare function setMinConfidenceRatioBuilder(tx: Transaction, args: SetMinConfidenceRatioBuilderArgs, options?: {
+    env?: EnvConfig;
+}): TransactionResult;
+export interface SetMaxStalenessSecondsBuilderArgs {
+    builder: TransactionObjectInput;
+    maxStalenessSeconds: bigint | TransactionArgument;
+}
+/** Seeded by `from` like the confidence multiplier. Must be non-zero. */
+export declare function setMaxStalenessSecondsBuilder(tx: Transaction, args: SetMaxStalenessSecondsBuilderArgs, options?: {
+    env?: EnvConfig;
+}): TransactionResult;
 export interface SetArgs {
     builder: TransactionObjectInput;
     field: GenericArg;

package/_generated/suilend/reserve-config/functions.js

@@ -531,6 +531,29 @@ export function setConfidenceMultiplierBuilder(tx, args, options) {
         ],
     });
 }
+/**
+ * Seeded by `from` like the confidence multiplier. Must be non-zero, and must stay
+ * above the confidence multiplier `k` (see `build`).
+ */
+export function setMinConfidenceRatioBuilder(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_min_confidence_ratio_builder`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.minConfidenceRatio, `u64`),
+        ],
+    });
+}
+/** Seeded by `from` like the confidence multiplier. Must be non-zero. */
+export function setMaxStalenessSecondsBuilder(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_max_staleness_seconds_builder`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.maxStalenessSeconds, `u64`),
+        ],
+    });
+}
 /**
  * Sets a field in the reserve configuration builder.
  *

package/client.d.ts

@@ -4,6 +4,7 @@ import { Transaction, TransactionArgument, TransactionObjectArgument, Transactio
 import { SuiPythClient } from "@pythnetwork/pyth-sui-js";
 import BigNumber from "bignumber.js";
 import { Decimal } from "./_generated/suilend/decimal/structs";
+import { type ConfidenceShare } from "./utils/simulate";
 import { LendingMarket, ObligationOwnerCap } from "./_generated/suilend/lending-market/structs";
 import { Obligation } from "./_generated/suilend/obligation/structs";
 import { NewConfigArgs as CreateRateLimiterConfigArgs } from "./_generated/suilend/rate-limiter/functions";
@@ -55,6 +56,8 @@ export type ClaimRewardsReward = {
 };
 export type PatchReserveConfigArgs = Partial<CreateReserveConfigArgs> & {
     confidenceMultiplierBps?: bigint | TransactionArgument;
+    minConfidenceRatio?: bigint | TransactionArgument;
+    maxStalenessSeconds?: bigint | TransactionArgument;
 };
 export type LendingMarketObject = {
     objectId: string;
@@ -103,8 +106,8 @@ export declare class SuilendClient {
     }>;
     /** A reserve's confidence multiplier `k`, in bps; pass `parsedReserve.config.additionalFields.id`. 0 when unset. */
     static getReserveConfidenceMultiplierBps(suiGrpcClient: SuiGrpcClient, additionalFieldsBagId: string): Promise<BigNumber>;
-    /** A reserve's stored Pyth confidence (the `ConfidenceKey` dynamic field on `reserve.id` directly, not inside `config.additionalFields`). Reads as 0 until the reserve's first price update writes it. */
-    static getReserveStoredConfidence(suiGrpcClient: SuiGrpcClient, reserveId: string): Promise<BigNumber>;
+    /** A reserve's stored Pyth confidence as a share of the spot it was read with, `conf / spot` (the `ConfidenceKey` dynamic field on `reserve.id` directly, not inside `config.additionalFields`). Reads as 0 until the reserve's first price update writes it. */
+    static getReserveConfidenceShare(suiGrpcClient: SuiGrpcClient, reserveId: string): Promise<ConfidenceShare>;
     /** The raw spot and EMA of the reserve's last refresh under a price guard (the `RawPriceKey` dynamic field on `reserve.id`). Undefined until its first refresh under a guard. Attach them with `withUnclampedPrices` only to a reserve as stored on chain, never to one a feed refresh has repriced. */
     static getReserveRawPrices(suiGrpcClient: SuiGrpcClient, reserveId: string): Promise<{
         price: Decimal;

package/client.js

@@ -5,7 +5,7 @@ import BigNumber from "bignumber.js";
 import { extractCTokenCoinType, getAllCoins, getSpendableCoin, } from "@suilend/sui-core";
 import { phantom } from "./_generated/_framework/reified.js";
 import { Decimal } from "./_generated/suilend/decimal/structs.js";
-import { decimalToBigNumber } from "./utils/simulate.js";
+import { confidenceShare, decimalToBigNumber, } from "./utils/simulate.js";
 import { PKG_V10, setPublishedAt } from "./_generated/suilend/index.js";
 import { getPublishedAt } from "./_generated/_envs/index.js";
 import { PACKAGE_ID } from "./_generated/suilend/index.js";
@@ -14,7 +14,7 @@ import { LendingMarket, ObligationOwnerCap, } from "./_generated/suilend/lending
 import { createLendingMarket } from "./_generated/suilend/lending-market-registry/functions.js";
 import { Obligation } from "./_generated/suilend/obligation/structs.js";
 import { newConfig as createRateLimiterConfig, } from "./_generated/suilend/rate-limiter/functions.js";
-import { build as buildReserveConfig, createReserveConfig, setBorrowFeeBps, setBorrowLimit, setBorrowLimitUsd, setBorrowWeightBps, setCloseAttributedBorrowLimitUsd, setCloseLtvPct, setConfidenceMultiplierBuilder, setDepositLimit, setDepositLimitUsd, setInterestRateAprs, setInterestRateUtils, setIsolated, setLiquidationBonusBps, setMaxCloseLtvPct, setMaxLiquidationBonusBps, setOpenAttributedBorrowLimitUsd, setOpenLtvPct, setProtocolLiquidationFeeBps, setSpreadFeeBps, } from "./_generated/suilend/reserve-config/functions.js";
+import { build as buildReserveConfig, createReserveConfig, setBorrowFeeBps, setBorrowLimit, setBorrowLimitUsd, setBorrowWeightBps, setCloseAttributedBorrowLimitUsd, setCloseLtvPct, setConfidenceMultiplierBuilder, setDepositLimit, setDepositLimitUsd, setInterestRateAprs, setInterestRateUtils, setIsolated, setLiquidationBonusBps, setMaxCloseLtvPct, setMaxLiquidationBonusBps, setMaxStalenessSecondsBuilder, setMinConfidenceRatioBuilder, setOpenAttributedBorrowLimitUsd, setOpenLtvPct, setProtocolLiquidationFeeBps, setSpreadFeeBps, } from "./_generated/suilend/reserve-config/functions.js";
 import { addReserveProCompatible, addReserveV2ProCompatible, changeReservePriceFeedProCompatible, priceInfoPublishTime, refreshReservePriceProCompatible, } from "./lib/proCompatible.js";
 import { resolvePriceUpdateDataSource, } from "./lib/pyth.js";
 import { Side } from "./lib/types.js";
@@ -467,11 +467,11 @@ export class SuilendClient {
         });
         return new BigNumber(bcs.u64().parse(dynamicField.value.bcs));
     }
-    /** A reserve's stored Pyth confidence (the `ConfidenceKey` dynamic field on `reserve.id` directly, not inside `config.additionalFields`). Reads as 0 until the reserve's first price update writes it. */
-    static async getReserveStoredConfidence(suiGrpcClient, reserveId) {
+    /** A reserve's stored Pyth confidence as a share of the spot it was read with, `conf / spot` (the `ConfidenceKey` dynamic field on `reserve.id` directly, not inside `config.additionalFields`). Reads as 0 until the reserve's first price update writes it. */
+    static async getReserveConfidenceShare(suiGrpcClient, reserveId) {
         const match = await findBagEntryByTypeSuffix(suiGrpcClient, reserveId, "::reserve::ConfidenceKey");
         if (!match)
-            return new BigNumber(0);
+            return confidenceShare(new BigNumber(0), new BigNumber(0));
         const { dynamicField } = await suiGrpcClient.getDynamicField({
             parentId: reserveId,
             name: match.name,
@@ -694,6 +694,16 @@ export class SuilendClient {
                 builder,
                 confidenceMultiplierBps: overrides.confidenceMultiplierBps,
             });
+        if (overrides.minConfidenceRatio !== undefined)
+            setMinConfidenceRatioBuilder(transaction, {
+                builder,
+                minConfidenceRatio: overrides.minConfidenceRatio,
+            });
+        if (overrides.maxStalenessSeconds !== undefined)
+            setMaxStalenessSecondsBuilder(transaction, {
+                builder,
+                maxStalenessSeconds: overrides.maxStalenessSeconds,
+            });
         const [config] = buildReserveConfig(transaction, builder);
         return this.submitReserveConfigUpdate(lendingMarketOwnerCapId, transaction, coinType, config);
     }

package/lib/initialize.d.ts

@@ -158,6 +158,7 @@ export type InitializePriceInputs = {
 export declare const getInitializePriceInputs: (lendingMarkets: {
     reserves: Reserve<string>[];
 }[], nowMs: number) => InitializePriceInputs;
+type ConfidenceByCoinType = simulate.ConfidenceByCoinType;
 export declare const initializeSuilendAll: (suiGrpcClient: SuiGrpcClient, markets: InitializeSuilendMarket[], fallbackPythEndpoint?: string, options?: InitializeSuilendOptions) => Promise<{
     lendingMarket: {
         version: bigint;
@@ -410,6 +411,10 @@ export declare const initializeSuilendAll: (suiGrpcClient: SuiGrpcClient, market
         description: string;
         totalDeposits: BigNumber;
     }>;
+    confidenceByCoinType: Map<string, {
+        readonly share: simulate.ConfidenceShare | undefined;
+        readonly kBps: BigNumber;
+    }>;
     reserveCoinTypes: string[];
     reserveCoinMetadataMap: Record<string, import("@suilend/sui-core").Token>;
     rewardCoinTypes: string[];
@@ -669,6 +674,10 @@ export declare const initializeSuilendWithRewardsAll: (suiGrpcClient: SuiGrpcCli
         description: string;
         totalDeposits: BigNumber;
     }>;
+    confidenceByCoinType: Map<string, {
+        readonly share: simulate.ConfidenceShare | undefined;
+        readonly kBps: BigNumber;
+    }>;
     reserveCoinTypes: string[];
     reserveCoinMetadataMap: Record<string, import("@suilend/sui-core").Token>;
     rewardCoinTypes: string[];
@@ -927,6 +936,10 @@ export declare const initializeSuilend: (suiGrpcClient: SuiGrpcClient, suilendCl
         description: string;
         totalDeposits: BigNumber;
     }>;
+    confidenceByCoinType: Map<string, {
+        readonly share: simulate.ConfidenceShare | undefined;
+        readonly kBps: BigNumber;
+    }>;
     reserveCoinTypes: string[];
     reserveCoinMetadataMap: Record<string, import("@suilend/sui-core").Token>;
     rewardCoinTypes: string[];
@@ -952,7 +965,7 @@ export type OwnedObligations = {
     obligationErrors: Record<string, unknown>;
 };
 export declare const fetchOwnedObligations: (suiGrpcClient: SuiGrpcClient, address: string) => Promise<OwnedObligations>;
-export declare const parseOwnedObligations: (owned: OwnedObligations, suilendClient: SuilendClient, refreshedRawReserves: Reserve<string>[], reserveMap: Record<string, ParsedReserve>) => {
+export declare const parseOwnedObligations: (owned: OwnedObligations, suilendClient: SuilendClient, refreshedRawReserves: Reserve<string>[], reserveMap: Record<string, ParsedReserve>, confidenceByCoinType?: ConfidenceByCoinType) => {
     strategyOwnerCaps: StrategyOwnerCap[];
     strategyObligations: {
         id: string;
@@ -1474,7 +1487,7 @@ export declare const parseOwnedObligations: (owned: OwnedObligations, suilendCli
         minPriceBorrowLimit: BigNumber;
     }[];
 };
-export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suilendClient: SuilendClient, refreshedRawReserves: Reserve<string>[], reserveMap: Record<string, ParsedReserve>, address?: string) => Promise<{
+export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suilendClient: SuilendClient, refreshedRawReserves: Reserve<string>[], reserveMap: Record<string, ParsedReserve>, address?: string, confidenceByCoinType?: ConfidenceByCoinType) => Promise<{
     strategyOwnerCaps: StrategyOwnerCap[];
     strategyObligations: {
         id: string;

package/lib/initialize.js

@@ -1,5 +1,6 @@
 import { normalizeStructTag, parseStructTag } from "@mysten/sui/utils";
 import BigNumber from "bignumber.js";
+import pLimit from "p-limit";
 import { NORMALIZED_ALKIMI_COINTYPE, NORMALIZED_AUSD_COINTYPE, NORMALIZED_BLUE_COINTYPE, NORMALIZED_BUCK_COINTYPE, NORMALIZED_DEEP_COINTYPE, NORMALIZED_DMC_COINTYPE, NORMALIZED_FUD_COINTYPE, NORMALIZED_HAEDAL_COINTYPE, NORMALIZED_HIPPO_COINTYPE, NORMALIZED_IKA_COINTYPE, NORMALIZED_KOBAN_COINTYPE, NORMALIZED_LBTC_COINTYPE, NORMALIZED_NS_COINTYPE, NORMALIZED_SEND_COINTYPE, NORMALIZED_SEND_POINTS_S1_COINTYPE, NORMALIZED_SEND_POINTS_S2_COINTYPE, NORMALIZED_SOL_COINTYPE, NORMALIZED_SUI_COINTYPE, NORMALIZED_UP_COINTYPE, NORMALIZED_USDB_COINTYPE, NORMALIZED_USDC_COINTYPE, NORMALIZED_USDsui_COINTYPE, NORMALIZED_WAL_COINTYPE, NORMALIZED_WBTC_COINTYPE, NORMALIZED_WETH_COINTYPE, NORMALIZED_XAUm_COINTYPE, NORMALIZED_eEARN_COINTYPE, NORMALIZED_eTHIRD_COINTYPE, NORMALIZED_flSUI_COINTYPE, NORMALIZED_fpSUI_COINTYPE, NORMALIZED_fudSUI_COINTYPE, NORMALIZED_iSUI_COINTYPE, NORMALIZED_jugSUI_COINTYPE, NORMALIZED_kSUI_COINTYPE, NORMALIZED_mSUI_COINTYPE, NORMALIZED_mUSD_COINTYPE, NORMALIZED_oshiSUI_COINTYPE, NORMALIZED_sSUI_COINTYPE, NORMALIZED_sdeUSD_COINTYPE, NORMALIZED_stratSUI_COINTYPE, NORMALIZED_suiETH_COINTYPE, NORMALIZED_suiUSDT_COINTYPE, NORMALIZED_suiUSDe_COINTYPE, NORMALIZED_suiWBTC_COINTYPE, NORMALIZED_trevinSUI_COINTYPE, NORMALIZED_upSUI_COINTYPE, NORMALIZED_wUSDC_COINTYPE, NORMALIZED_wUSDT_COINTYPE, NORMALIZED_xBTC_COINTYPE, NORMALIZED_yapSUI_COINTYPE, TEMPORARY_PYTH_PRICE_FEED_COINTYPES, getCoinMetadataMapPartial, getPrices, isSendPoints, isSteammPoints, } from "@suilend/sui-core";
 import { phantom } from "../_generated/_framework/reified.js";
 import { PACKAGE_ID } from "../_generated/suilend/index.js";
@@ -310,7 +311,34 @@ const fillRewardPriceMap = (rewardPriceMap, reservelessActiveRewardCoinTypes, ca
     }
     return rewardPriceMap;
 };
-const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options, includeRewards) => {
+const kBpsByConfigBagId = new Map();
+const confidenceReadLimit = pLimit(8);
+const configConfidenceMultiplierBps = (suiGrpcClient, bagId) => {
+    const cached = kBpsByConfigBagId.get(bagId);
+    if (cached)
+        return cached;
+    const read = confidenceReadLimit(() => SuilendClient.getReserveConfidenceMultiplierBps(suiGrpcClient, bagId));
+    kBpsByConfigBagId.set(bagId, read);
+    read.catch(() => kBpsByConfigBagId.delete(bagId));
+    return read;
+};
+const reserveConfidenceMultipliers = (suiGrpcClient, reserves) => Promise.all(reserves.map(async (reserve) => {
+    const { id: bagId, size } = reserve.config.element
+        .additionalFields;
+    const kBps = BigInt(size) === BigInt(0)
+        ? new BigNumber(0)
+        : await configConfidenceMultiplierBps(suiGrpcClient, bagId);
+    return [normalizeStructTag(reserve.coinType), kBps];
+})).then((entries) => new Map(entries));
+const reserveConfidenceByCoinType = async (suiGrpcClient, reserves, kBpsByCoinType) => new Map(await Promise.all(reserves.map(async (reserve) => {
+    const coinType = normalizeStructTag(reserve.coinType);
+    const kBps = kBpsByCoinType.get(coinType) ?? new BigNumber(0);
+    const share = kBps.isZero() || simulate.isRefreshedFromFeed(reserve)
+        ? undefined
+        : await confidenceReadLimit(() => SuilendClient.getReserveConfidenceShare(suiGrpcClient, reserve.id));
+    return [coinType, { share, kBps }];
+})));
+const initializeSuilendMarkets = async (suiGrpcClient, markets, fallbackPythEndpoint, options, includeRewards) => {
     const nowMs = Date.now();
     const nowS = Math.floor(nowMs / 1000);
     const fetchPrices = options?.fetchPrices ?? getPrices;
@@ -330,7 +358,7 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
     });
     const coinTypesByMarket = reservesByMarket.map(({ withoutTemporaryPythPriceFeeds, withTemporaryPythPriceFeeds }) => marketCoinTypes([...withoutTemporaryPythPriceFeeds, ...withTemporaryPythPriceFeeds], nowMs));
     const reservelessActiveRewardCoinTypesByMarket = coinTypesByMarket.map(reservelessActiveRewardCoinTypes);
-    const [[refreshedWithoutTemporaryByMarket, fabricatedPriceCoinTypesByMarket], coinMetadataByMarket, rewardUsdPrices,] = await Promise.all([
+    const [[refreshedWithoutTemporaryByMarket, fabricatedPriceCoinTypesByMarket], coinMetadataByMarket, rewardUsdPrices, kBpsByMarket,] = await Promise.all([
         Promise.all([
             resolvePythConnection(options?.pythConnection, fallbackPythEndpoint, options?.pythConnectionConfig).then((pythConnection) => refreshReservesForInitializeAll(reservesByMarket.map((r) => r.withoutTemporaryPythPriceFeeds), pythConnection, options?.tolerateMissingPriceFeeds)),
             priceTemporaryPythFeedReservesAll(reservesByMarket.map((r) => r.withTemporaryPythPriceFeeds), fetchPrices),
@@ -346,6 +374,7 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
                 return {};
             })
             : Promise.resolve({}),
+        Promise.all(markets.map(({ suilendClient }) => reserveConfidenceMultipliers(suiGrpcClient, suilendClient.lendingMarket.reserves))),
     ]);
     const prepared = markets.map(({ suilendClient, lendingMarketMetadata }, index) => {
         const refreshedRawReserves = [
@@ -379,6 +408,7 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
             ...coinTypesByMarket[index],
         };
     });
+    const confidenceByMarket = await Promise.all(prepared.map(({ refreshedRawReserves }, index) => reserveConfidenceByCoinType(suiGrpcClient, refreshedRawReserves, kBpsByMarket[index])));
     const initialized = prepared.map(({ suilendClient, lendingMarketMetadata, refreshedRawReserves, unpricedCoinTypes, uniqueReserveCoinTypes, uniqueRewardCoinTypes, uniqueActiveRewardsCoinTypes, }, index) => {
         const { coinMetadataMap, reserveCoinMetadataMap, rewardCoinMetadataMap } = coinMetadataByMarket[index];
         // const walReserve = refreshedRawReserves.find(
@@ -391,7 +421,7 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
         //   (walReserve.price.value as bigint) = walPrice;
         //   (walReserve.smoothedPrice.value as bigint) = walPrice;
         // }
-        const lendingMarket = parseLendingMarket(suilendClient.lendingMarket, refreshedRawReserves, coinMetadataMap, nowS, lendingMarketMetadata);
+        const lendingMarket = parseLendingMarket(suilendClient.lendingMarket, refreshedRawReserves, coinMetadataMap, nowS, lendingMarketMetadata, confidenceByMarket[index]);
         const reserveOrder = resolveReserveOrder(lendingMarket.id, lendingMarketMetadata);
         if (reserveOrder) {
             lendingMarket.reserves = sortReservesByOrder(lendingMarket.reserves, reserveOrder);
@@ -403,6 +433,7 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
             refreshedRawReserves,
             unpricedCoinTypes,
             reserveMap,
+            confidenceByCoinType: confidenceByMarket[index],
             reserveCoinTypes: uniqueReserveCoinTypes,
             reserveCoinMetadataMap,
             rewardCoinTypes: uniqueRewardCoinTypes,
@@ -416,11 +447,11 @@ const initializeSuilendMarkets = async (markets, fallbackPythEndpoint, options,
     return { initialized, rewardPriceMaps };
 };
 export const initializeSuilendAll = async (suiGrpcClient, markets, fallbackPythEndpoint, options) => {
-    const { initialized } = await initializeSuilendMarkets(markets, fallbackPythEndpoint, options, false);
+    const { initialized } = await initializeSuilendMarkets(suiGrpcClient, markets, fallbackPythEndpoint, options, false);
     return initialized;
 };
 export const initializeSuilendWithRewardsAll = async (suiGrpcClient, markets, fallbackPythEndpoint, options) => {
-    const { initialized, rewardPriceMaps } = await initializeSuilendMarkets(markets, fallbackPythEndpoint, options, true);
+    const { initialized, rewardPriceMaps } = await initializeSuilendMarkets(suiGrpcClient, markets, fallbackPythEndpoint, options, true);
     return initialized.map((market, index) => ({
         ...market,
         rewardPriceMap: rewardPriceMaps[index],
@@ -518,9 +549,9 @@ const obligationIdsOf = ({ strategyOwnerCaps, obligationOwnerCaps, }) => [
     ...strategyOwnerCaps.map((soc) => soc.obligationId),
     ...obligationOwnerCaps.map((ownerCap) => ownerCap.obligationId),
 ];
-const parseMarketObligations = (rawObligations, { strategyOwnerCaps, obligationOwnerCaps }, refreshedRawReserves, reserveMap) => {
+const parseMarketObligations = (rawObligations, { strategyOwnerCaps, obligationOwnerCaps }, refreshedRawReserves, reserveMap, confidenceByCoinType) => {
     const obligations = rawObligations
-        .map((rawObligation) => simulate.refreshObligation(rawObligation, refreshedRawReserves))
+        .map((rawObligation) => simulate.refreshObligation(rawObligation, refreshedRawReserves, confidenceByCoinType))
         .map((refreshedObligation) => parseObligation(refreshedObligation, reserveMap, strategyOwnerCaps.some((soc) => soc.obligationId === refreshedObligation.id)))
         .sort((a, b) => +b.netValueUsd.minus(a.netValueUsd));
     const strategyObligations = obligations.filter((o) => strategyOwnerCaps.some((soc) => soc.obligationId === o.id));
@@ -568,7 +599,7 @@ export const fetchOwnedObligations = async (suiGrpcClient, address) => {
         obligationErrors,
     };
 };
-export const parseOwnedObligations = (owned, suilendClient, refreshedRawReserves, reserveMap) => {
+export const parseOwnedObligations = (owned, suilendClient, refreshedRawReserves, reserveMap, confidenceByCoinType) => {
     const marketCaps = selectMarketCaps(owned, suilendClient);
     const obligationsById = new Map(owned.obligations.map((obligation) => [obligation.id, obligation]));
     const rawObligations = obligationIdsOf(marketCaps).map((obligationId) => {
@@ -579,9 +610,9 @@ export const parseOwnedObligations = (owned, suilendClient, refreshedRawReserves
             throw owned.obligationErrors[obligationId];
         throw new Error(`Obligation ${obligationId} is not in the owned obligations`);
     });
-    return parseMarketObligations(rawObligations, marketCaps, refreshedRawReserves, reserveMap);
+    return parseMarketObligations(rawObligations, marketCaps, refreshedRawReserves, reserveMap, confidenceByCoinType);
 };
-export const initializeObligations = async (suiGrpcClient, suilendClient, refreshedRawReserves, reserveMap, address) => {
+export const initializeObligations = async (suiGrpcClient, suilendClient, refreshedRawReserves, reserveMap, address, confidenceByCoinType) => {
     if (!address)
         return {
             strategyOwnerCaps: [],
@@ -591,5 +622,5 @@ export const initializeObligations = async (suiGrpcClient, suilendClient, refres
         };
     const marketCaps = selectMarketCaps(await listOwnedCaps(suiGrpcClient, address, hasStrategies(suilendClient)), suilendClient);
     const rawObligations = await SuilendClient.getObligations(obligationIdsOf(marketCaps), suilendClient.lendingMarket.$typeArgs, suiGrpcClient);
-    return parseMarketObligations(rawObligations, marketCaps, refreshedRawReserves, reserveMap);
+    return parseMarketObligations(rawObligations, marketCaps, refreshedRawReserves, reserveMap, confidenceByCoinType);
 };

package/package.json

@@ -1 +1 @@
-{"name":"@suilend/sdk","version":"13.7.0-next.ge2ee95d","private":false,"description":"A TypeScript SDK for interacting with the Suilend program","author":"Suilend","license":"MIT","main":"./index.js","exports":{".":"./index.js","./client":"./client.js","./mmt":"./mmt.js","./strategies":"./strategies.js","./api/events":"./api/events.js","./api":"./api/index.js","./lib/constants":"./lib/constants.js","./lib":"./lib/index.js","./lib/initialize":"./lib/initialize.js","./lib/liquidityMining":"./lib/liquidityMining.js","./lib/proCompatible":"./lib/proCompatible.js","./lib/pyth":"./lib/pyth.js","./lib/strategyOwnerCap":"./lib/strategyOwnerCap.js","./lib/transactions":"./lib/transactions.js","./lib/types":"./lib/types.js","./margin":"./margin/index.js","./parsers/apiReserveAssetDataEvent":"./parsers/apiReserveAssetDataEvent.js","./parsers":"./parsers/index.js","./parsers/lendingMarket":"./parsers/lendingMarket.js","./parsers/obligation":"./parsers/obligation.js","./parsers/rateLimiter":"./parsers/rateLimiter.js","./parsers/reserve":"./parsers/reserve.js","./swap":"./swap/index.js","./swap/quote":"./swap/quote.js","./swap/transaction":"./swap/transaction.js","./utils/events":"./utils/events.js","./utils/feedId":"./utils/feedId.js","./utils":"./utils/index.js","./utils/interpolate":"./utils/interpolate.js","./utils/obligation":"./utils/obligation.js","./utils/priceGuard":"./utils/priceGuard.js","./utils/simulate":"./utils/simulate.js","./_generated/_envs":"./_generated/_envs/index.js","./_generated/_envs/mainnet":"./_generated/_envs/mainnet.js","./_generated/_framework/env":"./_generated/_framework/env.js","./_generated/_framework/reified":"./_generated/_framework/reified.js","./_generated/_framework/util":"./_generated/_framework/util.js","./_generated/_framework/vector":"./_generated/_framework/vector.js","./_generated/suilend":"./_generated/suilend/index.js","./margin/margin/admin_cap":"./margin/margin/admin_cap.js","./margin/margin/market":"./margin/margin/market.js","./margin/margin/permissions":"./margin/margin/permissions.js","./margin/margin/position":"./margin/margin/position.js","./margin/margin/router":"./margin/margin/router.js","./margin/margin/version":"./margin/margin/version.js","./margin/utils":"./margin/utils/index.js","./_generated/suilend/cell/structs":"./_generated/suilend/cell/structs.js","./_generated/suilend/decimal/structs":"./_generated/suilend/decimal/structs.js","./_generated/suilend/lending-market/functions":"./_generated/suilend/lending-market/functions.js","./_generated/suilend/lending-market/structs":"./_generated/suilend/lending-market/structs.js","./_generated/suilend/lending-market-registry/functions":"./_generated/suilend/lending-market-registry/functions.js","./_generated/suilend/liquidity-mining/structs":"./_generated/suilend/liquidity-mining/structs.js","./_generated/suilend/obligation/structs":"./_generated/suilend/obligation/structs.js","./_generated/suilend/rate-limiter/functions":"./_generated/suilend/rate-limiter/functions.js","./_generated/suilend/rate-limiter/structs":"./_generated/suilend/rate-limiter/structs.js","./_generated/suilend/reserve/structs":"./_generated/suilend/reserve/structs.js","./_generated/suilend/reserve-config/functions":"./_generated/suilend/reserve-config/functions.js","./_generated/suilend/reserve-config/structs":"./_generated/suilend/reserve-config/structs.js","./_generated/_dependencies/pyth-2/price-identifier/structs":"./_generated/_dependencies/pyth-2/price-identifier/structs.js","./_generated/_dependencies/std/ascii/structs":"./_generated/_dependencies/std/ascii/structs.js","./_generated/_dependencies/std/option/structs":"./_generated/_dependencies/std/option/structs.js","./_generated/_dependencies/std/type-name/structs":"./_generated/_dependencies/std/type-name/structs.js","./_generated/_dependencies/sui/bag/structs":"./_generated/_dependencies/sui/bag/structs.js","./_generated/_dependencies/sui/balance/structs":"./_generated/_dependencies/sui/balance/structs.js","./_generated/_dependencies/sui/object/structs":"./_generated/_dependencies/sui/object/structs.js","./_generated/_dependencies/sui/object-table/structs":"./_generated/_dependencies/sui/object-table/structs.js","./margin/margin/deps/std/type_name":"./margin/margin/deps/std/type_name.js","./margin/margin/deps/sui/vec_set":"./margin/margin/deps/sui/vec_set.js","./margin/margin/deps/suilend/lending_market":"./margin/margin/deps/suilend/lending_market.js"},"types":"./index.d.ts","scripts":{"codegen":"node ./codegen.js","codegen:install":"node ./install-codegen.js","build":"rm -rf ./dist && tsc && node ./fix-esm-imports.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","test":"vitest run","lint:ci":"yarn run typecheck","prettier":"prettier --write src/ tests/","release":"yarn run build && node ./release.js && cd ./dist && npm publish --access public"},"repository":{"type":"git","url":"git+https://github.com/fireflyprotocol/lending-mono.git","directory":"ts/sdks/sdk"},"dependencies":{"@bluefin-exchange/bluefin7k-aggregator-sdk":"7.7.0","@cetusprotocol/aggregator-sdk":"1.7.3","@flowx-finance/sdk":"2.1.0","@pythnetwork/hermes-client":"3.1.0","@pythnetwork/pyth-sui-js":"4.0.0","@suilend/springsui-sdk":"4.1.0","bignumber.js":"11.1.5","bn.js":"5.2.5","crypto-js":"4.2.0","lodash":"4.18.1","p-limit":"7.3.3","uuid":"14.0.2"},"devDependencies":{"@mysten/bcs":"2.1.2","@mysten/sui":"2.35.0","@suilend/sui-core":"2.2.0","@tsconfig/recommended":"1.0.13","@types/bn.js":"5.2.0","@types/lodash":"4.17.26","@types/node":"26.6.5","fast-check":"4.10.2","prettier":"3.9.10","ts-node":"10.9.2","typescript":"6.0.3","vite":"8.3.4","vitest":"5.0.4"},"peerDependencies":{"@mysten/bcs":"^2.1.1","@mysten/sui":">=2.31.3 <3","@suilend/sui-core":"^2.0.1"},"type":"module"}
+{"name":"@suilend/sdk","version":"13.8.0-next.gbe76414","private":false,"description":"A TypeScript SDK for interacting with the Suilend program","author":"Suilend","license":"MIT","main":"./index.js","exports":{".":"./index.js","./client":"./client.js","./mmt":"./mmt.js","./strategies":"./strategies.js","./api/events":"./api/events.js","./api":"./api/index.js","./lib/constants":"./lib/constants.js","./lib":"./lib/index.js","./lib/initialize":"./lib/initialize.js","./lib/liquidityMining":"./lib/liquidityMining.js","./lib/proCompatible":"./lib/proCompatible.js","./lib/pyth":"./lib/pyth.js","./lib/strategyOwnerCap":"./lib/strategyOwnerCap.js","./lib/transactions":"./lib/transactions.js","./lib/types":"./lib/types.js","./margin":"./margin/index.js","./parsers/apiReserveAssetDataEvent":"./parsers/apiReserveAssetDataEvent.js","./parsers":"./parsers/index.js","./parsers/lendingMarket":"./parsers/lendingMarket.js","./parsers/obligation":"./parsers/obligation.js","./parsers/rateLimiter":"./parsers/rateLimiter.js","./parsers/reserve":"./parsers/reserve.js","./swap":"./swap/index.js","./swap/quote":"./swap/quote.js","./swap/transaction":"./swap/transaction.js","./utils/events":"./utils/events.js","./utils/feedId":"./utils/feedId.js","./utils":"./utils/index.js","./utils/interpolate":"./utils/interpolate.js","./utils/obligation":"./utils/obligation.js","./utils/priceGuard":"./utils/priceGuard.js","./utils/simulate":"./utils/simulate.js","./_generated/_envs":"./_generated/_envs/index.js","./_generated/_envs/mainnet":"./_generated/_envs/mainnet.js","./_generated/_framework/env":"./_generated/_framework/env.js","./_generated/_framework/reified":"./_generated/_framework/reified.js","./_generated/_framework/util":"./_generated/_framework/util.js","./_generated/_framework/vector":"./_generated/_framework/vector.js","./_generated/suilend":"./_generated/suilend/index.js","./margin/margin/admin_cap":"./margin/margin/admin_cap.js","./margin/margin/market":"./margin/margin/market.js","./margin/margin/permissions":"./margin/margin/permissions.js","./margin/margin/position":"./margin/margin/position.js","./margin/margin/router":"./margin/margin/router.js","./margin/margin/version":"./margin/margin/version.js","./margin/utils":"./margin/utils/index.js","./_generated/suilend/cell/structs":"./_generated/suilend/cell/structs.js","./_generated/suilend/decimal/structs":"./_generated/suilend/decimal/structs.js","./_generated/suilend/lending-market/functions":"./_generated/suilend/lending-market/functions.js","./_generated/suilend/lending-market/structs":"./_generated/suilend/lending-market/structs.js","./_generated/suilend/lending-market-registry/functions":"./_generated/suilend/lending-market-registry/functions.js","./_generated/suilend/liquidity-mining/structs":"./_generated/suilend/liquidity-mining/structs.js","./_generated/suilend/obligation/structs":"./_generated/suilend/obligation/structs.js","./_generated/suilend/rate-limiter/functions":"./_generated/suilend/rate-limiter/functions.js","./_generated/suilend/rate-limiter/structs":"./_generated/suilend/rate-limiter/structs.js","./_generated/suilend/reserve/structs":"./_generated/suilend/reserve/structs.js","./_generated/suilend/reserve-config/functions":"./_generated/suilend/reserve-config/functions.js","./_generated/suilend/reserve-config/structs":"./_generated/suilend/reserve-config/structs.js","./_generated/_dependencies/pyth-2/price-identifier/structs":"./_generated/_dependencies/pyth-2/price-identifier/structs.js","./_generated/_dependencies/std/ascii/structs":"./_generated/_dependencies/std/ascii/structs.js","./_generated/_dependencies/std/option/structs":"./_generated/_dependencies/std/option/structs.js","./_generated/_dependencies/std/type-name/structs":"./_generated/_dependencies/std/type-name/structs.js","./_generated/_dependencies/sui/bag/structs":"./_generated/_dependencies/sui/bag/structs.js","./_generated/_dependencies/sui/balance/structs":"./_generated/_dependencies/sui/balance/structs.js","./_generated/_dependencies/sui/object/structs":"./_generated/_dependencies/sui/object/structs.js","./_generated/_dependencies/sui/object-table/structs":"./_generated/_dependencies/sui/object-table/structs.js","./margin/margin/deps/std/type_name":"./margin/margin/deps/std/type_name.js","./margin/margin/deps/sui/vec_set":"./margin/margin/deps/sui/vec_set.js","./margin/margin/deps/suilend/lending_market":"./margin/margin/deps/suilend/lending_market.js"},"types":"./index.d.ts","scripts":{"codegen":"node ./codegen.js","codegen:install":"node ./install-codegen.js","build":"rm -rf ./dist && tsc && node ./fix-esm-imports.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","test":"vitest run","lint:ci":"yarn run typecheck","prettier":"prettier --write src/ tests/","release":"yarn run build && node ./release.js && cd ./dist && npm publish --access public"},"repository":{"type":"git","url":"git+https://github.com/fireflyprotocol/lending-mono.git","directory":"ts/sdks/sdk"},"dependencies":{"@bluefin-exchange/bluefin7k-aggregator-sdk":"7.7.0","@cetusprotocol/aggregator-sdk":"1.7.3","@flowx-finance/sdk":"2.1.0","@pythnetwork/hermes-client":"3.1.0","@pythnetwork/pyth-sui-js":"4.0.0","@suilend/springsui-sdk":"4.1.0","bignumber.js":"11.1.5","bn.js":"5.2.5","crypto-js":"4.2.0","lodash":"4.18.1","p-limit":"7.3.3","uuid":"14.0.2"},"devDependencies":{"@mysten/bcs":"2.1.2","@mysten/sui":"2.35.0","@suilend/sui-core":"2.2.0","@tsconfig/recommended":"1.0.13","@types/bn.js":"5.2.0","@types/lodash":"4.17.26","@types/node":"26.6.5","fast-check":"4.10.2","prettier":"3.9.10","ts-node":"10.9.2","typescript":"6.0.3","vite":"8.3.4","vitest":"5.0.4"},"peerDependencies":{"@mysten/bcs":"^2.1.1","@mysten/sui":">=2.31.3 <3","@suilend/sui-core":"^2.0.1"},"type":"module"}

package/parsers/apiReserveAssetDataEvent.js

@@ -1,7 +1,7 @@
 import { normalizeStructTag } from "@mysten/sui/utils";
 import BigNumber from "bignumber.js";
 import { WAD } from "../lib/constants.js";
-import { applyConfidenceMargin } from "../utils/simulate.js";
+import { applyConfidenceMargin, confidenceShare } from "../utils/simulate.js";
 // Reproduces the exact pre-confidence-margin bounds when a caller doesn't
 // supply the reserve's current multiplier.
 const ZERO_K_BPS = new BigNumber(0);
@@ -37,7 +37,7 @@ kBps = ZERO_K_BPS) => {
         ? new BigNumber(event.unclampedSmoothedPrice).div(WAD)
         : smoothedPrice;
     const rangePrices = [price, smoothedPrice, unclampedPrice, unclampedSmoothedPrice];
-    const { lowerBound: minPrice, upperBound: maxPrice } = applyConfidenceMargin(BigNumber.min(...rangePrices), BigNumber.max(...rangePrices), conf, kBps, unclampedPrice);
+    const { lowerBound: minPrice, upperBound: maxPrice } = applyConfidenceMargin(BigNumber.min(...rangePrices), BigNumber.max(...rangePrices), confidenceShare(conf, unclampedPrice), kBps);
     // Custom
     const utilizationPercent = depositedAmount.eq(0)
         ? new BigNumber(0)

package/parsers/lendingMarket.d.ts

@@ -3,8 +3,9 @@ import BigNumber from "bignumber.js";
 import { LendingMarket } from "../_generated/suilend/lending-market/structs";
 import { Reserve } from "../_generated/suilend/reserve/structs";
 import { LendingMarketMetadata } from "../lib";
+import * as simulate from "../utils/simulate";
 export type ParsedLendingMarket = ReturnType<typeof parseLendingMarket>;
-export declare const parseLendingMarket: (lendingMarket: LendingMarket<string>, reserves: Reserve<string>[], coinMetadataMap: Record<string, SuiClientTypes.CoinMetadata>, nowS: number, lendingMarketMetadata?: LendingMarketMetadata) => {
+export declare const parseLendingMarket: (lendingMarket: LendingMarket<string>, reserves: Reserve<string>[], coinMetadataMap: Record<string, SuiClientTypes.CoinMetadata>, nowS: number, lendingMarketMetadata?: LendingMarketMetadata, confidenceByCoinType?: simulate.ConfidenceByCoinType) => {
     version: bigint;
     reserves: {
         config: {

package/parsers/lendingMarket.js

@@ -1,11 +1,18 @@
+import { normalizeStructTag } from "@mysten/sui/utils";
 import BigNumber from "bignumber.js";
+import * as simulate from "../utils/simulate.js";
 import { parseRateLimiter } from "./rateLimiter.js";
 import { parseReserve } from "./reserve.js";
-export const parseLendingMarket = (lendingMarket, reserves, coinMetadataMap, nowS, lendingMarketMetadata) => {
+export const parseLendingMarket = (lendingMarket, reserves, coinMetadataMap, nowS, lendingMarketMetadata, confidenceByCoinType) => {
     const id = lendingMarket.id;
     const type = lendingMarket.$typeArgs[0];
     const version = lendingMarket.version;
-    const parsedReserves = reserves.map((reserve) => parseReserve(reserve, coinMetadataMap));
+    const normalizedConfidence = confidenceByCoinType &&
+        simulate.normalizeConfidenceByCoinType(confidenceByCoinType);
+    const parsedReserves = reserves.map((reserve) => {
+        const confidence = simulate.resolveConfidence(normalizedConfidence?.get(normalizeStructTag(reserve.coinType)), reserve);
+        return parseReserve(reserve, coinMetadataMap, confidence?.share, confidence?.kBps);
+    });
     const obligations = lendingMarket.obligations;
     const parsedRateLimiter = parseRateLimiter(lendingMarket.rateLimiter, nowS);
     const feeReceiver = lendingMarket.feeReceiver;

package/parsers/reserve.d.ts

@@ -2,11 +2,12 @@ import { SuiClientTypes } from "@mysten/sui/client";
 import BigNumber from "bignumber.js";
 import { PoolReward, PoolRewardManager } from "../_generated/suilend/liquidity-mining/structs";
 import { Reserve } from "../_generated/suilend/reserve/structs";
+import * as simulate from "../utils/simulate";
 export type ParsedReserve = ReturnType<typeof parseReserve>;
 export type ParsedReserveConfig = ReturnType<typeof parseReserveConfig>;
 export type ParsedPoolRewardManager = ReturnType<typeof parsePoolRewardManager>;
 export type ParsedPoolReward = NonNullable<ReturnType<typeof parsePoolReward>>;
-export declare const parseReserve: (reserve: Reserve<string>, coinMetadataMap: Record<string, SuiClientTypes.CoinMetadata>, conf?: BigNumber, kBps?: BigNumber) => {
+export declare const parseReserve: (reserve: Reserve<string>, coinMetadataMap: Record<string, SuiClientTypes.CoinMetadata>, share?: simulate.ConfidenceShare, kBps?: BigNumber) => {
     config: {
         $typeName: `${string}::reserve_config::ReserveConfig`;
         openLtvPct: number;

package/parsers/reserve.js

@@ -5,14 +5,14 @@ import { WAD } from "../lib/constants.js";
 import { toHexString } from "../utils/index.js";
 import * as simulate from "../utils/simulate.js";
 export const parseReserve = (reserve, coinMetadataMap, 
-// The reserve's stored Pyth confidence and its CURRENT confidence
+// The reserve's stored conf / spot share and its CURRENT confidence
 // multiplier (in bps) -- a ConfidenceKey dynamic field and a
 // ReserveConfig.additionalFields Bag entry respectively, neither of which
 // lives on the Reserve object's own BCS content, so this parser can't
 // fetch them itself without becoming async. Omit either (or both) for
 // plain bounds. The raw prices of a guarded reserve come attached with
 // simulate.withUnclampedPrices.
-conf, kBps) => {
+share, kBps) => {
     const config = parseReserveConfig(reserve);
     const $typeName = reserve.$typeName;
     const id = reserve.id;
@@ -24,7 +24,9 @@ conf, kBps) => {
     const price = new BigNumber(reserve.price.value.toString()).div(WAD);
     const smoothedPrice = new BigNumber(reserve.smoothedPrice.value.toString()).div(WAD);
     const { low, high } = simulate.priceRange(reserve);
-    const { lowerBound: minPrice, upperBound: maxPrice } = simulate.applyConfidenceMargin(low, high, conf !== undefined && kBps !== undefined ? conf : new BigNumber(0), kBps ?? new BigNumber(0), simulate.unclampedSpot(reserve));
+    const { lowerBound: minPrice, upperBound: maxPrice } = share !== undefined && kBps !== undefined
+        ? simulate.applyConfidenceMargin(low, high, share, kBps)
+        : { lowerBound: low, upperBound: high };
     const priceLastUpdateTimestampS = reserve.priceLastUpdateTimestampS;
     const availableAmount = new BigNumber(reserve.availableAmount.toString()).div(10 ** mintDecimals);
     const ctokenSupply = new BigNumber(reserve.ctokenSupply.toString()).div(10 ** mintDecimals);

package/utils/priceGuard.d.ts

@@ -6,7 +6,12 @@ export type PriceGuardState = {
     anchorTimestampS: bigint;
 };
 export declare const clampToBand: (anchor: bigint, price: bigint, bandBps: bigint) => bigint;
-export declare const applyPriceGuard: (price: bigint, smoothedPrice: bigint, guard: PriceGuardState) => {
+export type StoredPrices = {
+    price: bigint;
+    smoothedPrice: bigint;
+};
+export declare const nextAnchor: (anchor: bigint, stored: bigint, incoming: bigint, bandBps: bigint) => bigint;
+export declare const applyPriceGuard: (price: bigint, smoothedPrice: bigint, guard: PriceGuardState, nowS: bigint, stored: StoredPrices | null) => {
     price: bigint;
     smoothedPrice: bigint;
     wasClamped: boolean;

package/utils/priceGuard.js

@@ -14,11 +14,29 @@ export const clampToBand = (anchor, price, bandBps) => {
     const atLeastLower = price > lower ? price : lower;
     return atLeastLower < upper ? atLeastLower : upper;
 };
-// Models one refresh against the stored anchors. The chain advances the anchors after
-// clamping, which this does not, so callers must re-read the guard instead of chaining results.
-export const applyPriceGuard = (price, smoothedPrice, guard) => {
-    const clampedPrice = clampToBand(guard.priceAnchor, price, guard.maxPriceChangeBps);
-    const clampedSmoothedPrice = clampToBand(guard.smoothedPriceAnchor, smoothedPrice, guard.maxPriceChangeBps);
+export const nextAnchor = (anchor, stored, incoming, bandBps) => {
+    if (anchor === 0n)
+        return incoming;
+    const carried = clampToBand(anchor, stored, bandBps);
+    return carried === 0n ? clampToBand(anchor, incoming, bandBps) : carried;
+};
+// Models one refresh at nowS. Once the guard's interval has elapsed, the chain opens the
+// next one on the prices the reserve holds, so without `stored` this clamps against the
+// read anchors instead and can land up to a band off. The chain also writes the anchors,
+// which this does not, so callers must re-read the guard instead of chaining results.
+export const applyPriceGuard = (price, smoothedPrice, guard, nowS, stored) => {
+    const band = guard.maxPriceChangeBps;
+    const opens = stored != null &&
+        band > 0n &&
+        nowS - guard.anchorTimestampS >= guard.minUpdateIntervalS;
+    const priceAnchor = opens
+        ? nextAnchor(guard.priceAnchor, stored.price, price, band)
+        : guard.priceAnchor;
+    const smoothedPriceAnchor = opens
+        ? nextAnchor(guard.smoothedPriceAnchor, stored.smoothedPrice, smoothedPrice, band)
+        : guard.smoothedPriceAnchor;
+    const clampedPrice = clampToBand(priceAnchor, price, band);
+    const clampedSmoothedPrice = clampToBand(smoothedPriceAnchor, smoothedPrice, band);
     return {
         price: clampedPrice,
         smoothedPrice: clampedSmoothedPrice,

package/utils/simulate.d.ts

@@ -146,6 +146,29 @@ export type ObligationRefresh = {
     weightedBorrowedValueUsd: BigNumber;
     weightedBorrowedValueUpperBoundUsd: BigNumber;
 };
+/**
+ * `conf / spot` from a single price read: what a reserve stores in
+ * `ConfidenceKey`. Branded so a USD conf cannot be passed where a share is
+ * expected; build one with `confidenceShare`.
+ */
+export type ConfidenceShare = BigNumber & {
+    readonly __brand: "ConfidenceShare";
+};
+/** Mirrors reserve.move's `record_confidence`: a zero spot records a zero share. */
+export declare const confidenceShare: (conf: BigNumber, spot: BigNumber) => ConfidenceShare;
+export type ConfidenceByCoinType = Map<string, {
+    share: ConfidenceShare | undefined;
+    kBps: BigNumber;
+}>;
+export declare const normalizeConfidenceByCoinType: (confidenceByCoinType: ConfidenceByCoinType) => ConfidenceByCoinType;
+export declare const isRefreshedFromFeed: (reserve: Reserve<string>) => boolean;
+export declare const resolveConfidence: (entry: {
+    share: ConfidenceShare | undefined;
+    kBps: BigNumber;
+} | undefined, reserve: Reserve<string>) => {
+    share: ConfidenceShare;
+    kBps: BigNumber;
+} | undefined;
 /**
  * Pure computation half of `refreshObligation`: same math, but returns fresh
  * deposits/borrows/reward-manager arrays and the five USD aggregates instead
@@ -155,31 +178,28 @@ export type ObligationRefresh = {
  * shallow-copied), silently corrupting `unrefreshedObligation` for anyone still
  * holding a reference to it.
  */
-export declare function computeObligationRefresh(obligation: Obligation<string>, refreshedReserves: Reserve<string>[], nowMs: number, confidenceByCoinType?: Map<string, {
-    conf?: BigNumber;
-    kBps: BigNumber;
-}>): ObligationRefresh;
-export declare const refreshObligation: (unrefreshedObligation: Obligation<string>, refreshedReserves: Reserve<string>[]) => Obligation<string>;
+export declare function computeObligationRefresh(obligation: Obligation<string>, refreshedReserves: Reserve<string>[], nowMs: number, confidenceByCoinType?: ConfidenceByCoinType): ObligationRefresh;
+export declare const refreshObligation: (unrefreshedObligation: Obligation<string>, refreshedReserves: Reserve<string>[], confidenceByCoinType?: ConfidenceByCoinType) => Obligation<string>;
 export declare const numberToDecimal: (value: number) => Decimal;
 export declare const stringToDecimal: (value: string) => Decimal;
 export declare const decimalToBigNumber: (value: Decimal) => BigNumber;
 /**
  * Mirrors reserve.move's `price_lower_bound`/`price_upper_bound`: the one
  * off-chain place this formula lives. `low` and `high` are the ends of the
- * reserve's price range (`priceRange`), which the bounds widen by the share
- * `k * conf / spot`, where `spot` is the unclamped spot of the same update
- * `conf` came from. `conf` and `kBps` are the reserve's stored
- * Pyth confidence and its `ReserveConfig` confidence multiplier (in bps, e.g.
- * 30000 for a logical k=3) -- both plain human-scale BigNumbers, not
- * WAD-scaled Decimals. `kBps=0` or `conf=0` disables the margin entirely:
- * both bounds collapse to `low` and `high`.
+ * reserve's price range (`priceRange`), which the bounds widen by
+ * `k * share`. `share` is `conf / spot` from a single price read -- what the
+ * reserve stores in `ConfidenceKey` -- and `kBps` is its `ReserveConfig`
+ * confidence multiplier (in bps, e.g. 30000 for a logical k=3); both are
+ * plain human-scale BigNumbers, not WAD-scaled Decimals. `kBps=0` or
+ * `share=0` disables the margin entirely: both bounds collapse to `low` and
+ * `high`.
  */
-export declare const applyConfidenceMargin: (low: BigNumber, high: BigNumber, conf: BigNumber, kBps: BigNumber, spot: BigNumber) => {
+export declare const applyConfidenceMargin: (low: BigNumber, high: BigNumber, share: ConfidenceShare, kBps: BigNumber) => {
     lowerBound: BigNumber;
     upperBound: BigNumber;
 };
 export declare const getCTokenMarketValue: (reserve: Reserve<string>, depositedCTokenAmount: BigNumber) => BigNumber;
-export declare const getCTokenMarketValueLowerBound: (reserve: Reserve<string>, depositedCTokenAmount: BigNumber, conf?: BigNumber, kBps?: BigNumber) => BigNumber;
+export declare const getCTokenMarketValueLowerBound: (reserve: Reserve<string>, depositedCTokenAmount: BigNumber, share?: ConfidenceShare, kBps?: BigNumber) => BigNumber;
 export declare const cTokenRatio: (reserve: Reserve<string>) => BigNumber;
 export declare const totalSupply: (reserve: Reserve<string>) => BigNumber;
 export declare const compoundBorrowedAmount: (snapshotAmount: BigNumber, currentCumulativeBorrowRate: BigNumber, snapshotCumulativeBorrowRate: BigNumber) => BigNumber;

package/utils/simulate.js

@@ -352,18 +352,29 @@ export const findReserveOrThrow = (reserves, coinType) => {
 // (`v * WAD / 10_000`); dividing in BigNumber here matches that.
 export const computeBorrowWeight = (config) => new BigNumber(config.borrowWeightBps.toString()).div(10000);
 export const computeCloseLtv = (config) => new BigNumber(config.closeLtvPct / 100);
-const resolveConfidence = (entry, reserve) => {
+/** Mirrors reserve.move's `record_confidence`: a zero spot records a zero share. */
+export const confidenceShare = (conf, spot) => (spot.isZero() ? new BigNumber(0) : conf.dividedBy(spot));
+const ZERO_SHARE = confidenceShare(new BigNumber(0), new BigNumber(0));
+export const normalizeConfidenceByCoinType = (confidenceByCoinType) => new Map([...confidenceByCoinType].map(([coinType, entry]) => [
+    normalizeStructTag(coinType),
+    entry,
+]));
+export const isRefreshedFromFeed = (reserve) => "feedConfidence" in reserve;
+export const resolveConfidence = (entry, reserve) => {
     if (entry === undefined)
         return undefined;
-    const refreshedFromFeed = "feedConfidence" in reserve;
-    const conf = feedConfidenceOf(reserve) ??
-        (refreshedFromFeed ? undefined : entry.conf) ??
-        (entry.kBps.isZero() ? new BigNumber(0) : undefined);
-    if (conf === undefined)
+    const refreshedFromFeed = isRefreshedFromFeed(reserve);
+    const feedConf = feedConfidenceOf(reserve);
+    const share = (feedConf !== undefined
+        ? confidenceShare(feedConf, unclampedSpot(reserve))
+        : undefined) ??
+        (refreshedFromFeed ? undefined : entry.share) ??
+        (entry.kBps.isZero() ? ZERO_SHARE : undefined);
+    if (share === undefined)
         throw new Error(refreshedFromFeed
-            ? `Reserve ${reserve.coinType} was refreshed from a feed without conf, so the stored conf is from a different update: use a feed that carries conf`
-            : `No conf for reserve ${reserve.coinType}: refresh it from a feed that carries conf, or supply conf in the entry`);
-    return { conf, kBps: entry.kBps };
+            ? `Reserve ${reserve.coinType} was refreshed from a feed without conf, so the stored share is from a different update: use a feed that carries conf`
+            : `No conf for reserve ${reserve.coinType}: refresh it from a feed that carries conf, or supply the stored share in the entry`);
+    return { share, kBps: entry.kBps };
 };
 /**
  * Pure computation half of `refreshObligation`: same math, but returns fresh
@@ -376,18 +387,15 @@ const resolveConfidence = (entry, reserve) => {
  */
 export function computeObligationRefresh(obligation, refreshedReserves, nowMs, 
 // Per-reserve CURRENT confidence multiplier, keyed by coinType in either
-// raw or normalized form. `conf` is the fallback for a reserve that was never
-// price-refreshed; a reserve refreshed from a feed without `conf` throws
-// instead (unless kBps is 0), because its price and the stored conf come from
-// different updates. A reserve's own `feedConfidence` takes precedence because
-// it comes from the same update as its price. A reserve with no entry here
-// gets plain min/max(price, smoothedPrice) bounds.
+// raw or normalized form. `share` is the reserve's stored conf / spot
+// (`SuilendClient.getReserveConfidenceShare`), the fallback for a reserve that
+// was never price-refreshed; a reserve refreshed from a feed without `conf`
+// throws instead (unless kBps is 0), because its price and the stored share
+// come from different updates. A reserve's own `feedConfidence` takes
+// precedence because it comes from the same update as its price. A reserve
+// with no entry here gets plain min/max(price, smoothedPrice) bounds.
 confidenceByCoinType) {
-    const normalizedConfidence = confidenceByCoinType &&
-        new Map([...confidenceByCoinType].map(([coinType, entry]) => [
-            normalizeStructTag(coinType),
-            entry,
-        ]));
+    const normalizedConfidence = confidenceByCoinType && normalizeConfidenceByCoinType(confidenceByCoinType);
     const userRewardManagers = [...obligation.userRewardManagers];
     let depositValueUsd = new BigNumber(0);
     let allowedBorrowValueUsd = new BigNumber(0);
@@ -400,7 +408,7 @@ confidenceByCoinType) {
             updateUserRewardManager(reserve.depositsPoolRewardManager, userRewardManagers[Number(deposit.userRewardManagerIndex)], nowMs);
         const confidence = resolveConfidence(normalizedConfidence?.get(normalizeStructTag(deposit.coinType)), reserve);
         const marketValue = getCTokenMarketValue(reserve, new BigNumber(deposit.depositedCtokenAmount.toString()));
-        const marketValueLowerBound = getCTokenMarketValueLowerBound(reserve, new BigNumber(deposit.depositedCtokenAmount.toString()), confidence?.conf, confidence?.kBps);
+        const marketValueLowerBound = getCTokenMarketValueLowerBound(reserve, new BigNumber(deposit.depositedCtokenAmount.toString()), confidence?.share, confidence?.kBps);
         deposit.marketValue = stringToDecimal(marketValue.toString());
         depositValueUsd = depositValueUsd.plus(new BigNumber(marketValue.toString()));
         allowedBorrowValueUsd = allowedBorrowValueUsd.plus(marketValueLowerBound.multipliedBy(new BigNumber(config.openLtvPct / 100)));
@@ -435,7 +443,8 @@ confidenceByCoinType) {
         const confidence = resolveConfidence(normalizedConfidence?.get(normalizeStructTag(unrefreshedBorrow.coinType)), reserve);
         const { low, high } = priceRange(reserve);
         const upperBoundPrice = confidence !== undefined
-            ? applyConfidenceMargin(low, high, confidence.conf, confidence.kBps, unclampedSpot(reserve)).upperBound
+            ? applyConfidenceMargin(low, high, confidence.share, confidence.kBps)
+                .upperBound
             : high;
         // `exactBorrowedAmount` (this borrow's own amount), not
         // `reserve.borrowedAmount`: the reserve field is the whole reserve's
@@ -467,8 +476,8 @@ confidenceByCoinType) {
         weightedBorrowedValueUpperBoundUsd,
     };
 }
-export const refreshObligation = (unrefreshedObligation, refreshedReserves) => {
-    const refresh = computeObligationRefresh(unrefreshedObligation, refreshedReserves, Date.now());
+export const refreshObligation = (unrefreshedObligation, refreshedReserves, confidenceByCoinType) => {
+    const refresh = computeObligationRefresh(unrefreshedObligation, refreshedReserves, Date.now(), confidenceByCoinType);
     return {
         ...unrefreshedObligation,
         deposits: refresh.deposits,
@@ -495,18 +504,18 @@ export const decimalToBigNumber = (value) => {
 /**
  * Mirrors reserve.move's `price_lower_bound`/`price_upper_bound`: the one
  * off-chain place this formula lives. `low` and `high` are the ends of the
- * reserve's price range (`priceRange`), which the bounds widen by the share
- * `k * conf / spot`, where `spot` is the unclamped spot of the same update
- * `conf` came from. `conf` and `kBps` are the reserve's stored
- * Pyth confidence and its `ReserveConfig` confidence multiplier (in bps, e.g.
- * 30000 for a logical k=3) -- both plain human-scale BigNumbers, not
- * WAD-scaled Decimals. `kBps=0` or `conf=0` disables the margin entirely:
- * both bounds collapse to `low` and `high`.
+ * reserve's price range (`priceRange`), which the bounds widen by
+ * `k * share`. `share` is `conf / spot` from a single price read -- what the
+ * reserve stores in `ConfidenceKey` -- and `kBps` is its `ReserveConfig`
+ * confidence multiplier (in bps, e.g. 30000 for a logical k=3); both are
+ * plain human-scale BigNumbers, not WAD-scaled Decimals. `kBps=0` or
+ * `share=0` disables the margin entirely: both bounds collapse to `low` and
+ * `high`.
  */
-export const applyConfidenceMargin = (low, high, conf, kBps, spot) => {
-    if (kBps.isZero() || conf.isZero())
+export const applyConfidenceMargin = (low, high, share, kBps) => {
+    if (kBps.isZero() || share.isZero())
         return { lowerBound: low, upperBound: high };
-    const fraction = kBps.dividedBy(10_000).multipliedBy(conf).dividedBy(spot);
+    const fraction = kBps.dividedBy(10_000).multipliedBy(share);
     const lowerBound = BigNumber.max(low.minus(low.multipliedBy(fraction)), new BigNumber(0));
     const upperBound = high.plus(high.multipliedBy(fraction));
     return { lowerBound, upperBound };
@@ -518,15 +527,14 @@ export const getCTokenMarketValue = (reserve, depositedCTokenAmount) => {
         .dividedBy(new BigNumber(10 ** reserve.mintDecimals));
 };
 export const getCTokenMarketValueLowerBound = (reserve, depositedCTokenAmount, 
-// The reserve's stored Pyth confidence and its CURRENT confidence
+// The reserve's stored conf / spot share and its CURRENT confidence
 // multiplier (in bps). Omit either (or both) for the plain
 // min(price, smoothedPrice) lower bound.
-conf, kBps) => {
+share, kBps) => {
     const liquidityAmount = depositedCTokenAmount.multipliedBy(cTokenRatio(reserve));
     const { low, high } = priceRange(reserve);
-    const lowerBoundPrice = conf !== undefined && kBps !== undefined
-        ? applyConfidenceMargin(low, high, conf, kBps, unclampedSpot(reserve))
-            .lowerBound
+    const lowerBoundPrice = share !== undefined && kBps !== undefined
+        ? applyConfidenceMargin(low, high, share, kBps).lowerBound
         : low;
     return lowerBoundPrice
         .multipliedBy(liquidityAmount)