@suilend/sdk 12.3.0-next.gcbeb44e → 12.4.0-next.g7a809d2

package/_generated/suilend/lending-market/functions.d.ts

@@ -58,6 +58,7 @@ export interface ClosePoolRewardArgs {
 }
 export declare function closePoolReward(tx: Transaction, typeArgs: [string, string], args: ClosePoolRewardArgs): import("@mysten/sui/transactions").TransactionResult;
 export declare function reserve(tx: Transaction, typeArgs: [string, string], lendingMarket: TransactionObjectInput): import("@mysten/sui/transactions").TransactionResult;
+export declare function reserveConfigBuilder(tx: Transaction, typeArgs: [string, string], lendingMarket: TransactionObjectInput): import("@mysten/sui/transactions").TransactionResult;
 export interface CompoundInterestArgs {
     lendingMarket: TransactionObjectInput;
     reserveArrayIndex: bigint | TransactionArgument;

package/_generated/suilend/lending-market/functions.js

@@ -107,6 +107,17 @@ export function reserve(tx, typeArgs, lendingMarket) {
         arguments: [obj(tx, lendingMarket)],
     });
 }
+// lending_market::reserve_config_builder has no published package to
+// regenerate a binding from yet, so this is hand-written to match the shape
+// codegen already produces for `reserve` above. Replace it with the real
+// generated output once this package publishes and the generator runs again.
+export function reserveConfigBuilder(tx, typeArgs, lendingMarket) {
+    return tx.moveCall({
+        target: `${PUBLISHED_AT}::lending_market::reserve_config_builder`,
+        typeArguments: typeArgs,
+        arguments: [obj(tx, lendingMarket)],
+    });
+}
 export function compoundInterest(tx, typeArg, args) {
     return tx.moveCall({
         target: `${PUBLISHED_AT}::lending_market::compound_interest`,

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

@@ -13,6 +13,11 @@ export interface SetSpreadFeeBpsArgs {
     spreadFeeBps: bigint | TransactionArgument;
 }
 export declare function setSpreadFeeBps(tx: Transaction, args: SetSpreadFeeBpsArgs): import("@mysten/sui/transactions").TransactionResult;
+export interface SetConfidenceMultiplierBuilderArgs {
+    builder: TransactionObjectInput;
+    confidenceMultiplierBps: bigint | TransactionArgument;
+}
+export declare function setConfidenceMultiplierBuilder(tx: Transaction, args: SetConfidenceMultiplierBuilderArgs): import("@mysten/sui/transactions").TransactionResult;
 export declare function spreadFee(tx: Transaction, config: TransactionObjectInput): import("@mysten/sui/transactions").TransactionResult;
 export declare function borrowFee(tx: Transaction, config: TransactionObjectInput): import("@mysten/sui/transactions").TransactionResult;
 export declare function borrowLimit(tx: Transaction, config: TransactionObjectInput): import("@mysten/sui/transactions").TransactionResult;

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

@@ -29,6 +29,21 @@ export function setSpreadFeeBps(tx, args) {
         arguments: [obj(tx, args.builder), pure(tx, args.spreadFeeBps, `u64`)],
     });
 }
+// reserve_config::set_confidence_multiplier_builder is published (v25), but
+// this SDK's PUBLISHED_AT/PKG_V* constants haven't been bumped to v25 yet, so
+// there's nothing to regenerate a binding from until that separate regen
+// pass happens. Hand-written to match the shape codegen already produces for
+// every other u64 builder setter in this file (e.g. setSpreadFeeBps above).
+// Replace it with the real generated output once that regen lands.
+export function setConfidenceMultiplierBuilder(tx, args) {
+    return tx.moveCall({
+        target: `${PUBLISHED_AT}::reserve_config::set_confidence_multiplier_builder`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.confidenceMultiplierBps, `u64`),
+        ],
+    });
+}
 export function spreadFee(tx, config) {
     return tx.moveCall({
         target: `${PUBLISHED_AT}::reserve_config::spread_fee`,

package/client.d.ts

@@ -1,13 +1,22 @@
 import { SuiClientTypes } from "@mysten/sui/client";
 import { SuiGrpcClient } from "@mysten/sui/grpc";
-import { Transaction, TransactionObjectArgument, TransactionObjectInput } from "@mysten/sui/transactions";
+import { Transaction, TransactionArgument, TransactionObjectArgument, TransactionObjectInput } from "@mysten/sui/transactions";
 import { SuiPythClient } from "@pythnetwork/pyth-sui-js";
+import BigNumber from "bignumber.js";
 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";
 import { CreateReserveConfigArgs } from "./_generated/suilend/reserve-config/functions";
 import { type PriceUpdateDataSource } from "./lib/pyth";
 import { Side } from "./lib/types";
+/**
+ * Signed Pyth update data the caller already fetched for `priceIds`, posted
+ * unconditionally instead of the on-chain staleness check deciding.
+ */
+export interface PriceUpdate {
+    priceIds: string[];
+    updateData: Buffer[];
+}
 export declare function needsPriceRefresh(stalenessSeconds: number): boolean;
 export declare const ADMIN_ADDRESS: string;
 export declare const LENDING_MARKET_REGISTRY_ID: string;
@@ -41,6 +50,9 @@ export type ClaimRewardsReward = {
     rewardCoinType: string;
     side: Side;
 };
+export type PatchReserveConfigArgs = Partial<CreateReserveConfigArgs> & {
+    confidenceMultiplierBps?: bigint | TransactionArgument;
+};
 export declare class SuilendClient {
     lendingMarket: LendingMarket<string>;
     suiGrpcClient: SuiGrpcClient;
@@ -71,6 +83,8 @@ export declare class SuilendClient {
         receivers: string[];
         weights: string[];
     }>;
+    /** A reserve's confidence multiplier `k`, in bps; pass `parsedReserve.config.additionalFields.id`. 0 when unset. */
+    static getReserveConfidenceMultiplierBps(suiGrpcClient: SuiGrpcClient, additionalFieldsBagId: string): Promise<BigNumber>;
     static createNewLendingMarket(registryId: string, lendingMarketType: string, transaction: Transaction): {
         NestedResult: [number, number];
         $kind: "NestedResult";
@@ -94,12 +108,19 @@ export declare class SuilendClient {
     claimRewardsAndSendToUser(ownerId: string, obligationOwnerCap: TransactionObjectInput, rewards: ClaimRewardsReward[], transaction: Transaction): Transaction;
     claimRewardsAndDeposit(ownerId: string, obligationOwnerCap: TransactionObjectInput, rewards: ClaimRewardsReward[], transaction: Transaction): Transaction;
     findReserveArrayIndex(coinType: string): bigint;
+    private submitReserveConfigUpdate;
     updateReserveConfig(lendingMarketOwnerCapId: string, transaction: Transaction, coinType: string, createReserveConfigArgs: CreateReserveConfigArgs): import("@mysten/sui/transactions").TransactionResult;
+    /**
+     * Updates a subset of a reserve's config fields, leaving every unspecified
+     * field -- including `additionalFields` entries like the confidence
+     * multiplier -- unchanged from the reserve's current on-chain value.
+     */
+    patchReserveConfig(lendingMarketOwnerCapId: string, transaction: Transaction, coinType: string, overrides: PatchReserveConfigArgs): import("@mysten/sui/transactions").TransactionResult;
     newObligationOwnerCap(transaction: Transaction, lendingMarketOwnerCapId: string, destinationAddress: string, obligationId: string): void;
     updateRateLimiterConfig(lendingMarketOwnerCapId: string, transaction: Transaction, newRateLimiterConfigArgs: CreateRateLimiterConfigArgs): import("@mysten/sui/transactions").TransactionResult;
     changeReservePriceFeed(lendingMarketOwnerCapId: string, coinType: string, pythPriceId: string, transaction: Transaction): Promise<import("@mysten/sui/transactions").TransactionResult>;
     createObligation(transaction: Transaction): import("@mysten/sui/transactions").TransactionResult;
-    refreshAll(transaction: Transaction, obligation?: Obligation<string>, coinTypes?: string[]): Promise<void>;
+    refreshAll(transaction: Transaction, obligation?: Obligation<string>, coinTypes?: string[], priceUpdate?: PriceUpdate): Promise<void>;
     refreshReservePrices(transaction: Transaction, priceInfoObjectId: string, reserveArrayIndex: bigint): Promise<void>;
     deposit(sendCoin: TransactionObjectInput, coinType: string, obligationOwnerCap: TransactionObjectInput, transaction: Transaction): void;
     depositIntoObligation(ownerId: string, coinType: string, value: string, transaction: Transaction, obligationOwnerCap: TransactionObjectInput): Promise<void>;
@@ -111,8 +132,8 @@ export declare class SuilendClient {
     borrowAndSendToUser(ownerId: string, obligationOwnerCap: TransactionObjectInput, obligationId: string, coinType: string, value: string, transaction: Transaction): Promise<void>;
     repay(obligationId: string, coinType: string, coin: TransactionObjectInput, transaction: Transaction): import("@mysten/sui/transactions").TransactionResult;
     repayIntoObligation(ownerId: string, obligationId: string, coinType: string, value: string, transaction: Transaction): Promise<import("@mysten/sui/transactions").TransactionResult>;
-    liquidateAndRedeem(transaction: Transaction, obligation: Obligation<string>, repayCoinType: string, withdrawCoinType: string, repayCoinId: TransactionObjectInput): Promise<import("@mysten/sui/transactions").TransactionResult>;
-    liquidate(transaction: Transaction, obligation: Obligation<string>, repayCoinType: string, withdrawCoinType: string, repayCoinId: TransactionObjectInput): Promise<import("@mysten/sui/transactions").TransactionResult>;
+    liquidateAndRedeem(transaction: Transaction, obligation: Obligation<string>, repayCoinType: string, withdrawCoinType: string, repayCoinId: TransactionObjectInput, priceUpdate?: PriceUpdate): Promise<import("@mysten/sui/transactions").TransactionResult>;
+    liquidate(transaction: Transaction, obligation: Obligation<string>, repayCoinType: string, withdrawCoinType: string, repayCoinId: TransactionObjectInput, priceUpdate?: PriceUpdate): Promise<import("@mysten/sui/transactions").TransactionResult>;
     migrate(transaction: Transaction, lendingMarketOwnerCapId: string): import("@mysten/sui/transactions").TransactionResult;
     claimFees(transaction: Transaction, coinType: string): import("@mysten/sui/transactions").TransactionResult;
     setFeeReceiversAndWeights(transaction: Transaction, lendingMarketOwnerCapId: string, receivers: string[], weights: bigint[]): import("@mysten/sui/transactions").TransactionResult;

package/client.js

@@ -1,15 +1,17 @@
+import { bcs } from "@mysten/sui/bcs";
 import { SUI_CLOCK_OBJECT_ID, SUI_SYSTEM_STATE_OBJECT_ID, normalizeStructTag, normalizeSuiObjectId, toHex, } from "@mysten/sui/utils";
 import { SuiPythClient } from "@pythnetwork/pyth-sui-js";
+import BigNumber from "bignumber.js";
 import { extractCTokenCoinType, getAllCoins, getSpendableCoin, } from "@suilend/sui-core";
 import { phantom } from "./_generated/_framework/reified.js";
 import { PKG_V10, setPublishedAt } from "./_generated/suilend/index.js";
 import { PACKAGE_ID, PUBLISHED_AT } from "./_generated/suilend/index.js";
-import { addPoolReward, borrowRequest, cancelPoolReward, claimFees, claimRewards, claimRewardsAndDeposit, closePoolReward, depositCtokensIntoObligation, depositLiquidityAndMintCtokens, fulfillLiquidityRequest, liquidate, migrate, newObligationOwnerCap, rebalanceStaker, redeemCtokensAndWithdrawLiquidityRequest, repay, setFeeReceivers, unstakeSuiFromStaker, updateRateLimiterConfig, updateReserveConfig, withdrawCtokens, } from "./_generated/suilend/lending-market/functions.js";
+import { addPoolReward, borrowRequest, cancelPoolReward, claimFees, claimRewards, claimRewardsAndDeposit, closePoolReward, depositCtokensIntoObligation, depositLiquidityAndMintCtokens, fulfillLiquidityRequest, liquidate, migrate, newObligationOwnerCap, rebalanceStaker, redeemCtokensAndWithdrawLiquidityRequest, repay, reserveConfigBuilder, setFeeReceivers, unstakeSuiFromStaker, updateRateLimiterConfig, updateReserveConfig, withdrawCtokens, } from "./_generated/suilend/lending-market/functions.js";
 import { LendingMarket, ObligationOwnerCap, } from "./_generated/suilend/lending-market/structs.js";
 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 { createReserveConfig, } 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, 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";
@@ -28,6 +30,7 @@ const isSui = (coinType) => normalizeStructTag(coinType) === NORMALIZED_SUI_COIN
 // refresh would come from a package the contract does not accept.
 const WORMHOLE_STATE_ID = "0xdbca52b9fb4f712e25f61f974586d93ac541bcf8389564f0323bb07215168b5c";
 const PYTH_STATE_ID = "0x03719fae774ddab3cfcaa53bbc046f0cbe21410019b6280811bf3f9f4b05839d";
+const normalizePriceIdentifier = (id) => id.toLowerCase().replace(/^0x/, "");
 // Mirrors suilend::oracles's MAX_FORWARD_SECONDS (move/contracts/suilend/sources/oracles.move);
 // `refresh_reserve_price` now rejects a forward-dated price the same as a stale one.
 const MAX_FORWARD_SECONDS = 60;
@@ -153,6 +156,87 @@ export async function listAllOwnedObjects(suiGrpcClient, owner, type, include) {
     cache.set(key, promise);
     return promise;
 }
+// One entry per CreateReserveConfigArgs field, each just closing over its
+// generated setter -- lets patchReserveConfig apply only the caller's
+// specified overrides with one loop instead of one copy-pasted
+// `if (overrides.x !== undefined) setX(...)` per field.
+const CREATE_RESERVE_CONFIG_FIELD_SETTERS = {
+    openLtvPct: (tx, builder, openLtvPct) => setOpenLtvPct(tx, { builder, openLtvPct }),
+    closeLtvPct: (tx, builder, closeLtvPct) => setCloseLtvPct(tx, { builder, closeLtvPct }),
+    maxCloseLtvPct: (tx, builder, maxCloseLtvPct) => setMaxCloseLtvPct(tx, { builder, maxCloseLtvPct }),
+    borrowWeightBps: (tx, builder, borrowWeightBps) => setBorrowWeightBps(tx, { builder, borrowWeightBps }),
+    depositLimit: (tx, builder, depositLimit) => setDepositLimit(tx, { builder, depositLimit }),
+    borrowLimit: (tx, builder, borrowLimit) => setBorrowLimit(tx, { builder, borrowLimit }),
+    liquidationBonusBps: (tx, builder, liquidationBonusBps) => setLiquidationBonusBps(tx, { builder, liquidationBonusBps }),
+    maxLiquidationBonusBps: (tx, builder, maxLiquidationBonusBps) => setMaxLiquidationBonusBps(tx, { builder, maxLiquidationBonusBps }),
+    depositLimitUsd: (tx, builder, depositLimitUsd) => setDepositLimitUsd(tx, { builder, depositLimitUsd }),
+    borrowLimitUsd: (tx, builder, borrowLimitUsd) => setBorrowLimitUsd(tx, { builder, borrowLimitUsd }),
+    borrowFeeBps: (tx, builder, borrowFeeBps) => setBorrowFeeBps(tx, { builder, borrowFeeBps }),
+    spreadFeeBps: (tx, builder, spreadFeeBps) => setSpreadFeeBps(tx, { builder, spreadFeeBps }),
+    protocolLiquidationFeeBps: (tx, builder, protocolLiquidationFeeBps) => setProtocolLiquidationFeeBps(tx, { builder, protocolLiquidationFeeBps }),
+    interestRateUtils: (tx, builder, interestRateUtils) => setInterestRateUtils(tx, { builder, interestRateUtils }),
+    interestRateAprs: (tx, builder, interestRateAprs) => setInterestRateAprs(tx, { builder, interestRateAprs }),
+    isolated: (tx, builder, isolated) => setIsolated(tx, { builder, isolated }),
+    openAttributedBorrowLimitUsd: (tx, builder, openAttributedBorrowLimitUsd) => setOpenAttributedBorrowLimitUsd(tx, {
+        builder,
+        openAttributedBorrowLimitUsd,
+    }),
+    closeAttributedBorrowLimitUsd: (tx, builder, closeAttributedBorrowLimitUsd) => setCloseAttributedBorrowLimitUsd(tx, {
+        builder,
+        closeAttributedBorrowLimitUsd,
+    }),
+};
+// A generic type parameter, unlike indexing CREATE_RESERVE_CONFIG_FIELD_SETTERS
+// with the union `keyof CreateReserveConfigArgs` directly at the call site,
+// keeps TS from expanding the call into one union branch per field (which
+// blows up into "union type too complex to represent").
+function applyCreateReserveConfigFieldOverride(tx, builder, overrides, key) {
+    const value = overrides[key];
+    if (value === undefined)
+        return;
+    // TS can't verify this call is sound (calling a mapped type indexed by a
+    // generic key produces a union of all 18 setter signatures, which blows up
+    // into "union type too complex to represent" rather than typechecking) --
+    // but it is: `value`'s type and CREATE_RESERVE_CONFIG_FIELD_SETTERS[key]'s
+    // parameter type are both CreateReserveConfigArgs[K] for the same K.
+    CREATE_RESERVE_CONFIG_FIELD_SETTERS[key](tx, builder, value);
+}
+// Only safe for a key with a fixed, known type tag; see findBagEntryByTypeSuffix
+// for one that can legitimately be absent.
+async function resolveDynamicFieldId(suiGrpcClient, parentId, nameType) {
+    const { dynamicField } = await suiGrpcClient.getDynamicField({
+        parentId,
+        name: { type: nameType, bcs: new Uint8Array([0]) },
+    });
+    return dynamicField.fieldId;
+}
+// For a key that's always present (getFeeReceivers), both calls' errors can
+// propagate through this combined helper unguarded.
+async function fetchDynamicFieldJson(suiGrpcClient, parentId, nameType) {
+    const fieldId = await resolveDynamicFieldId(suiGrpcClient, parentId, nameType);
+    const { object } = await suiGrpcClient.getObject({
+        objectId: fieldId,
+        include: { json: true },
+    });
+    return object.json;
+}
+// Scans by type-tag suffix, ignoring the package address: codegen doesn't
+// track a struct's originally-defining address, only the current PUBLISHED_AT.
+async function findBagEntryByTypeSuffix(suiGrpcClient, parentId, typeSuffix) {
+    let cursor = null;
+    while (true) {
+        const response = await suiGrpcClient.listDynamicFields({ parentId, cursor });
+        const match = response.dynamicFields.find((entry) => entry.name.type.endsWith(typeSuffix));
+        if (match)
+            return match;
+        if (!response.hasNextPage)
+            return undefined;
+        if (!response.cursor) {
+            throw new Error(`listDynamicFields for ${parentId} reported hasNextPage=true with no cursor to continue`);
+        }
+        cursor = response.cursor;
+    }
+}
 export class SuilendClient {
     lendingMarket;
     suiGrpcClient;
@@ -249,22 +333,22 @@ export class SuilendClient {
         });
     }
     static async getFeeReceivers(suiGrpcClient, lendingMarketId) {
-        const { dynamicField } = await suiGrpcClient.getDynamicField({
-            parentId: lendingMarketId,
-            name: {
-                type: `${PKG_V10}::lending_market::FeeReceiversKey`,
-                bcs: new Uint8Array([0]),
-            },
-        });
-        const { object } = await suiGrpcClient.getObject({
-            objectId: dynamicField.fieldId,
-            include: { json: true },
-        });
-        const json = object.json;
+        const json = await fetchDynamicFieldJson(suiGrpcClient, lendingMarketId, `${PKG_V10}::lending_market::FeeReceiversKey`);
         const receivers = json?.value?.receivers;
         const weights = json?.value?.weights;
         return { receivers, weights };
     }
+    /** A reserve's confidence multiplier `k`, in bps; pass `parsedReserve.config.additionalFields.id`. 0 when unset. */
+    static async getReserveConfidenceMultiplierBps(suiGrpcClient, additionalFieldsBagId) {
+        const match = await findBagEntryByTypeSuffix(suiGrpcClient, additionalFieldsBagId, "::reserve_config::ConfidenceMultiplierKey");
+        if (!match)
+            return new BigNumber(0);
+        const { dynamicField } = await suiGrpcClient.getDynamicField({
+            parentId: additionalFieldsBagId,
+            name: match.name,
+        });
+        return new BigNumber(bcs.u64().parse(dynamicField.value.bcs));
+    }
     static createNewLendingMarket(registryId, lendingMarketType, transaction) {
         const [ownerCap, lendingMarket] = createLendingMarket(transaction, lendingMarketType, transaction.object(registryId));
         transaction.moveCall({
@@ -429,8 +513,7 @@ export class SuilendClient {
         const arrayIndex = this.lendingMarket.reserves.findIndex((r) => normalizeStructTag(r.coinType.name) === normalizeStructTag(coinType));
         return BigInt(arrayIndex);
     }
-    updateReserveConfig(lendingMarketOwnerCapId, transaction, coinType, createReserveConfigArgs) {
-        const [config] = createReserveConfig(transaction, createReserveConfigArgs);
+    submitReserveConfigUpdate(lendingMarketOwnerCapId, transaction, coinType, config) {
         return updateReserveConfig(transaction, [this.lendingMarket.$typeArgs[0], coinType], {
             lendingMarketOwnerCap: transaction.object(lendingMarketOwnerCapId),
             lendingMarket: transaction.object(this.lendingMarket.id),
@@ -438,6 +521,28 @@ export class SuilendClient {
             config: transaction.object(config),
         });
     }
+    updateReserveConfig(lendingMarketOwnerCapId, transaction, coinType, createReserveConfigArgs) {
+        const [config] = createReserveConfig(transaction, createReserveConfigArgs);
+        return this.submitReserveConfigUpdate(lendingMarketOwnerCapId, transaction, coinType, config);
+    }
+    /**
+     * Updates a subset of a reserve's config fields, leaving every unspecified
+     * field -- including `additionalFields` entries like the confidence
+     * multiplier -- unchanged from the reserve's current on-chain value.
+     */
+    patchReserveConfig(lendingMarketOwnerCapId, transaction, coinType, overrides) {
+        const [builder] = reserveConfigBuilder(transaction, [this.lendingMarket.$typeArgs[0], coinType], transaction.object(this.lendingMarket.id));
+        for (const key of Object.keys(CREATE_RESERVE_CONFIG_FIELD_SETTERS)) {
+            applyCreateReserveConfigFieldOverride(transaction, builder, overrides, key);
+        }
+        if (overrides.confidenceMultiplierBps !== undefined)
+            setConfidenceMultiplierBuilder(transaction, {
+                builder,
+                confidenceMultiplierBps: overrides.confidenceMultiplierBps,
+            });
+        const [config] = buildReserveConfig(transaction, builder);
+        return this.submitReserveConfigUpdate(lendingMarketOwnerCapId, transaction, coinType, config);
+    }
     newObligationOwnerCap(transaction, lendingMarketOwnerCapId, destinationAddress, obligationId) {
         const [obligationOwnerCap] = newObligationOwnerCap(transaction, this.lendingMarket.$typeArgs[0], {
             lendingMarketOwnerCap: transaction.object(lendingMarketOwnerCapId),
@@ -475,7 +580,7 @@ export class SuilendClient {
             typeArguments: this.lendingMarket.$typeArgs,
         });
     }
-    async refreshAll(transaction, obligation, coinTypes) {
+    async refreshAll(transaction, obligation, coinTypes, priceUpdate) {
         const reserveArrayIndexToPriceId = new Map();
         if (obligation) {
             obligation.deposits.forEach((deposit) => {
@@ -505,8 +610,14 @@ export class SuilendClient {
             const priceInfoObjectId = await this.pythClient.getPriceFeedObjectId(priceIdentifiers[i]);
             priceInfoObjectIds[i] = priceInfoObjectId;
         })()));
-        const stalePriceIdentifiers = [];
-        await Promise.all(Object.entries(priceInfoObjectIds).map(([i, priceInfoObjectId]) => (async () => {
+        const suppliedPriceIdentifiers = new Set(priceUpdate?.priceIds.map(normalizePriceIdentifier));
+        if (priceUpdate?.priceIds.length) {
+            await this.pythClient.updatePriceFeeds(transaction, priceUpdate.updateData, priceUpdate.priceIds);
+        }
+        const stalePriceIdentifiers = new Set();
+        await Promise.all(Object.entries(priceInfoObjectIds)
+            .filter(([i]) => !suppliedPriceIdentifiers.has(normalizePriceIdentifier(priceIdentifiers[+i])))
+            .map(([i, priceInfoObjectId]) => (async () => {
             // Read the field directly: the generated parser's type check is
             // bound to one Pyth package address and would throw post-cutover.
             const { object } = await this.suiGrpcClient.getObject({
@@ -516,15 +627,16 @@ export class SuilendClient {
             const publishTime = priceInfoPublishTime(object.json, priceInfoObjectId);
             const stalenessSeconds = Date.now() / 1000 - Number(publishTime);
             if (needsPriceRefresh(stalenessSeconds)) {
-                stalePriceIdentifiers.push(priceIdentifiers[+i]);
+                stalePriceIdentifiers.add(priceIdentifiers[+i]);
             }
         })()));
-        if (stalePriceIdentifiers.length > 0) {
-            const stalePriceUpdateData = await this.pythConnection.getPriceFeedsUpdateData(stalePriceIdentifiers);
-            await this.pythClient.updatePriceFeeds(transaction, stalePriceUpdateData, stalePriceIdentifiers);
+        if (stalePriceIdentifiers.size > 0) {
+            const staleIds = [...stalePriceIdentifiers];
+            const stalePriceUpdateData = await this.pythConnection.getPriceFeedsUpdateData(staleIds);
+            await this.pythClient.updatePriceFeeds(transaction, stalePriceUpdateData, staleIds);
         }
         for (let i = 0; i < reserveArrayIndexes.length; i++) {
-            this.refreshReservePrices(transaction, priceInfoObjectIds[i], reserveArrayIndexes[i]);
+            await this.refreshReservePrices(transaction, priceInfoObjectIds[i], reserveArrayIndexes[i]);
         }
     }
     async refreshReservePrices(transaction, priceInfoObjectId, reserveArrayIndex) {
@@ -670,8 +782,8 @@ export class SuilendClient {
         transaction.transferObjects([sendCoin], transaction.pure.address(ownerId));
         return result;
     }
-    async liquidateAndRedeem(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId) {
-        const [ctokens, exemption] = await this.liquidate(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId);
+    async liquidateAndRedeem(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId, priceUpdate) {
+        const [ctokens, exemption] = await this.liquidate(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId, priceUpdate);
         const [optionalExemption] = transaction.moveCall({
             target: `0x1::option::some`,
             typeArguments: [
@@ -681,8 +793,8 @@ export class SuilendClient {
         });
         return this.redeem(ctokens, withdrawCoinType, optionalExemption, transaction);
     }
-    async liquidate(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId) {
-        await this.refreshAll(transaction, obligation);
+    async liquidate(transaction, obligation, repayCoinType, withdrawCoinType, repayCoinId, priceUpdate) {
+        await this.refreshAll(transaction, obligation, undefined, priceUpdate);
         return liquidate(transaction, [this.lendingMarket.$typeArgs[0], repayCoinType, withdrawCoinType], {
             lendingMarket: transaction.object(this.lendingMarket.id),
             obligationId: obligation.id,

package/lib/initialize.d.ts

@@ -167,6 +167,7 @@ export declare const initializeSuilendAll: (suiGrpcClient: SuiGrpcClient, market
                 isolated: boolean;
                 openAttributedBorrowLimitUsd: number;
                 closeAttributedBorrowLimitUsd: number;
+                additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                 interestRate: {
                     id: string;
                     utilPercent: BigNumber;
@@ -306,6 +307,7 @@ export declare const initializeSuilendAll: (suiGrpcClient: SuiGrpcClient, market
             isolated: boolean;
             openAttributedBorrowLimitUsd: number;
             closeAttributedBorrowLimitUsd: number;
+            additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
             interestRate: {
                 id: string;
                 utilPercent: BigNumber;
@@ -423,6 +425,7 @@ export declare const initializeSuilend: (suiGrpcClient: SuiGrpcClient, suilendCl
                 isolated: boolean;
                 openAttributedBorrowLimitUsd: number;
                 closeAttributedBorrowLimitUsd: number;
+                additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                 interestRate: {
                     id: string;
                     utilPercent: BigNumber;
@@ -562,6 +565,7 @@ export declare const initializeSuilend: (suiGrpcClient: SuiGrpcClient, suilendCl
             isolated: boolean;
             openAttributedBorrowLimitUsd: number;
             closeAttributedBorrowLimitUsd: number;
+            additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
             interestRate: {
                 id: string;
                 utilPercent: BigNumber;
@@ -708,6 +712,7 @@ export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suile
                     isolated: boolean;
                     openAttributedBorrowLimitUsd: number;
                     closeAttributedBorrowLimitUsd: number;
+                    additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                     interestRate: {
                         id: string;
                         utilPercent: BigNumber;
@@ -825,6 +830,7 @@ export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suile
                     isolated: boolean;
                     openAttributedBorrowLimitUsd: number;
                     closeAttributedBorrowLimitUsd: number;
+                    additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                     interestRate: {
                         id: string;
                         utilPercent: BigNumber;
@@ -966,6 +972,7 @@ export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suile
                     isolated: boolean;
                     openAttributedBorrowLimitUsd: number;
                     closeAttributedBorrowLimitUsd: number;
+                    additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                     interestRate: {
                         id: string;
                         utilPercent: BigNumber;
@@ -1083,6 +1090,7 @@ export declare const initializeObligations: (suiGrpcClient: SuiGrpcClient, suile
                     isolated: boolean;
                     openAttributedBorrowLimitUsd: number;
                     closeAttributedBorrowLimitUsd: number;
+                    additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                     interestRate: {
                         id: string;
                         utilPercent: BigNumber;

package/package.json

@@ -1 +1 @@
-{"name":"@suilend/sdk","version":"12.3.0-next.gcbeb44e","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/obligation":"./utils/obligation.js","./utils/simulate":"./utils/simulate.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/source/0x1":"./_generated/_dependencies/source/0x1/index.js","./_generated/_dependencies/source/0x2":"./_generated/_dependencies/source/0x2/index.js","./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e":"./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/index.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","./_generated/_dependencies/source/0x1/ascii/structs":"./_generated/_dependencies/source/0x1/ascii/structs.js","./_generated/_dependencies/source/0x1/option/structs":"./_generated/_dependencies/source/0x1/option/structs.js","./_generated/_dependencies/source/0x1/type-name/structs":"./_generated/_dependencies/source/0x1/type-name/structs.js","./_generated/_dependencies/source/0x2/bag/structs":"./_generated/_dependencies/source/0x2/bag/structs.js","./_generated/_dependencies/source/0x2/balance/structs":"./_generated/_dependencies/source/0x2/balance/structs.js","./_generated/_dependencies/source/0x2/object/structs":"./_generated/_dependencies/source/0x2/object/structs.js","./_generated/_dependencies/source/0x2/object-table/structs":"./_generated/_dependencies/source/0x2/object-table/structs.js","./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/price-identifier/structs":"./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/price-identifier/structs.js"},"types":"./index.d.ts","scripts":{"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.6.3","@cetusprotocol/aggregator-sdk":"1.7.2","@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.2","uuid":"14.0.2"},"devDependencies":{"@mysten/bcs":"2.1.1","@mysten/sui":"2.29.0","@suilend/sui-core":"2.1.0","@tsconfig/recommended":"1.0.13","@types/bn.js":"5.2.0","@types/lodash":"4.17.25","@types/node":"26.5.1","fast-check":"4.10.0","prettier":"3.9.6","ts-node":"10.9.2","typescript":"6.0.3","vite":"8.3.0","vitest":"5.0.0"},"peerDependencies":{"@mysten/bcs":"^2.1.1","@mysten/sui":">=2.22.1 <3","@suilend/sui-core":"^2.0.1"},"type":"module"}
+{"name":"@suilend/sdk","version":"12.4.0-next.g7a809d2","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/obligation":"./utils/obligation.js","./utils/simulate":"./utils/simulate.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/source/0x1":"./_generated/_dependencies/source/0x1/index.js","./_generated/_dependencies/source/0x2":"./_generated/_dependencies/source/0x2/index.js","./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e":"./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/index.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","./_generated/_dependencies/source/0x1/ascii/structs":"./_generated/_dependencies/source/0x1/ascii/structs.js","./_generated/_dependencies/source/0x1/option/structs":"./_generated/_dependencies/source/0x1/option/structs.js","./_generated/_dependencies/source/0x1/type-name/structs":"./_generated/_dependencies/source/0x1/type-name/structs.js","./_generated/_dependencies/source/0x2/bag/structs":"./_generated/_dependencies/source/0x2/bag/structs.js","./_generated/_dependencies/source/0x2/balance/structs":"./_generated/_dependencies/source/0x2/balance/structs.js","./_generated/_dependencies/source/0x2/object/structs":"./_generated/_dependencies/source/0x2/object/structs.js","./_generated/_dependencies/source/0x2/object-table/structs":"./_generated/_dependencies/source/0x2/object-table/structs.js","./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/price-identifier/structs":"./_generated/_dependencies/source/0x8d97f1cd6ac663735be08d1d2b6d02a159e711586461306ce60a2b7a6a565a9e/price-identifier/structs.js"},"types":"./index.d.ts","scripts":{"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.6.3","@cetusprotocol/aggregator-sdk":"1.7.2","@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.2","uuid":"14.0.2"},"devDependencies":{"@mysten/bcs":"2.1.1","@mysten/sui":"2.29.0","@suilend/sui-core":"2.1.0","@tsconfig/recommended":"1.0.13","@types/bn.js":"5.2.0","@types/lodash":"4.17.25","@types/node":"26.5.1","fast-check":"4.10.0","prettier":"3.9.6","ts-node":"10.9.2","typescript":"6.0.3","vite":"8.3.0","vitest":"5.0.0"},"peerDependencies":{"@mysten/bcs":"^2.1.1","@mysten/sui":">=2.22.1 <3","@suilend/sui-core":"^2.0.1"},"type":"module"}

package/parsers/lendingMarket.d.ts

@@ -25,6 +25,7 @@ export declare const parseLendingMarket: (lendingMarket: LendingMarket<string>,
             isolated: boolean;
             openAttributedBorrowLimitUsd: number;
             closeAttributedBorrowLimitUsd: number;
+            additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
             interestRate: {
                 id: string;
                 utilPercent: BigNumber;

package/parsers/obligation.d.ts

@@ -45,6 +45,7 @@ export declare const parseObligation: (obligation: Obligation<string>, parsedRes
                 isolated: boolean;
                 openAttributedBorrowLimitUsd: number;
                 closeAttributedBorrowLimitUsd: number;
+                additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                 interestRate: {
                     id: string;
                     utilPercent: BigNumber;
@@ -162,6 +163,7 @@ export declare const parseObligation: (obligation: Obligation<string>, parsedRes
                 isolated: boolean;
                 openAttributedBorrowLimitUsd: number;
                 closeAttributedBorrowLimitUsd: number;
+                additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
                 interestRate: {
                     id: string;
                     utilPercent: BigNumber;

package/parsers/reserve.d.ts

@@ -25,6 +25,7 @@ export declare const parseReserve: (reserve: Reserve<string>, coinMetadataMap: R
         isolated: boolean;
         openAttributedBorrowLimitUsd: number;
         closeAttributedBorrowLimitUsd: number;
+        additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
         interestRate: {
             id: string;
             utilPercent: BigNumber;
@@ -147,6 +148,7 @@ export declare const parseReserveConfig: (reserve: Reserve<string>) => {
     isolated: boolean;
     openAttributedBorrowLimitUsd: number;
     closeAttributedBorrowLimitUsd: number;
+    additionalFields: import("../_generated/_dependencies/source/0x2/bag/structs").Bag;
     interestRate: {
         id: string;
         utilPercent: BigNumber;

package/parsers/reserve.js

@@ -122,7 +122,7 @@ export const parseReserveConfig = (reserve) => {
     const isolated = config.isolated;
     const openAttributedBorrowLimitUsd = Number(config.openAttributedBorrowLimitUsd.toString());
     const closeAttributedBorrowLimitUsd = Number(config.closeAttributedBorrowLimitUsd.toString());
-    // additionalFields
+    const additionalFields = config.additionalFields;
     const interestRate = config.interestRateUtils.map((util, index) => ({
         id: uuidv4(),
         utilPercent: new BigNumber(util.toString()),
@@ -146,10 +146,12 @@ export const parseReserveConfig = (reserve) => {
         isolated,
         openAttributedBorrowLimitUsd,
         closeAttributedBorrowLimitUsd,
-        // additionalFields,
+        additionalFields,
         interestRate,
     };
 };
+// additionalFields is a Bag; read the confidence multiplier via
+// SuilendClient.getReserveConfidenceMultiplierBps(suiGrpcClient, additionalFields.id).
 export const parsePoolRewardManager = (poolRewardManager, coinMetadataMap) => {
     const $typeName = poolRewardManager.$typeName;
     const id = poolRewardManager.id;

package/strategies.d.ts

@@ -73,6 +73,7 @@ export declare const getStrategySuiReserve: (reserveMap: Record<string, ParsedRe
         isolated: boolean;
         openAttributedBorrowLimitUsd: number;
         closeAttributedBorrowLimitUsd: number;
+        additionalFields: import("./_generated/_dependencies/source/0x2/bag/structs").Bag;
         interestRate: {
             id: string;
             utilPercent: BigNumber;
@@ -202,6 +203,7 @@ export declare const getStrategyDefaultCurrencyReserve: (reserveMap: Record<stri
         isolated: boolean;
         openAttributedBorrowLimitUsd: number;
         closeAttributedBorrowLimitUsd: number;
+        additionalFields: import("./_generated/_dependencies/source/0x2/bag/structs").Bag;
         interestRate: {
             id: string;
             utilPercent: BigNumber;
@@ -297,7 +299,8 @@ export declare const getStrategyBorrowedAmount: (reserveMap: Record<string, Pars
 export declare const getStrategyTvlAmount: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, obligation?: ParsedObligation) => BigNumber;
 export declare const getStrategyExposure: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, obligation?: ParsedObligation) => BigNumber;
 export declare const getStrategyStepMaxBorrowedAmount: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, deposits: StrategyDeposit[], borrowedAmount: BigNumber) => BigNumber;
-export declare const getStrategyStepMaxWithdrawnAmount: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, deposits: StrategyDeposit[], borrowedAmount: BigNumber, withdrawCoinType: string) => BigNumber;
+export declare const getStrategyStepMaxWithdrawnAmount: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, deposits: StrategyDeposit[], borrowedAmount: BigNumber, withdrawCoinType: string, headroomBuffer?: number) => BigNumber;
+export declare const getStrategyRebalanceDepositAmount: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, deposits: StrategyDeposit[], borrowedAmount: BigNumber) => BigNumber;
 export declare const strategySimulateLoopToExposure: (reserveMap: Record<string, ParsedReserve>, lstMap: StrategyLstMap, strategyType: StrategyType, _deposits: StrategyDeposit[], _borrowedAmount: BigNumber, _targetBorrowedAmount: BigNumber | undefined, _targetExposure: BigNumber | undefined) => {
     deposits: StrategyDeposit[];
     borrowedAmount: BigNumber;

package/strategies.js

@@ -10,7 +10,7 @@ import { getNetAprPercent } from "./lib/index.js";
 import { getRewardsMap } from "./lib/liquidityMining.js";
 import { STRATEGY_TYPE_INFO_MAP, StrategyType, strategyBorrow, strategyClaimRewardsAndMergeCoins, strategyDeposit, strategyWithdraw, } from "./lib/strategyOwnerCap.js";
 import { MMT_CONTRACT_PACKAGE_ID, MMT_VERSION_OBJECT_ID } from "./mmt.js";
-import { getWeightedBorrowsUsd } from "./utils/index.js";
+import { bisectionMethod, getWeightedBorrowsUsd } from "./utils/index.js";
 export const STRATEGY_E = 10 ** -7;
 export const STRATEGY_FLASH_REPAY_MAX_RESIDUAL_USD = 0.1;
 /**
@@ -591,7 +591,7 @@ export const getStrategyStepMaxWithdrawnAmount = (
 // AppContext
 reserveMap, 
 // Strategy
-lstMap, strategyType, deposits, borrowedAmount, withdrawCoinType) => {
+lstMap, strategyType, deposits, borrowedAmount, withdrawCoinType, headroomBuffer = 1) => {
     const depositReserves = getStrategyDepositReserves(reserveMap, strategyType);
     const borrowReserve = getStrategyBorrowReserve(reserveMap, strategyType);
     const defaultCurrencyReserve = getStrategyDefaultCurrencyReserve(reserveMap, strategyType);
@@ -608,10 +608,33 @@ lstMap, strategyType, deposits, borrowedAmount, withdrawCoinType) => {
                 .minus(obligation.maxPriceWeightedBorrowsUsd)
                 .div(withdrawReserve.minPrice)
                 .div(withdrawReserve.config.openLtvPct / 100)
+                .decimalPlaces(withdrawReserve.token.decimals, BigNumber.ROUND_DOWN)
+                .times(headroomBuffer)
             : MAX_U64, // Infinity
     deposits.find((deposit) => deposit.coinType === withdrawReserve.coinType)
         ?.depositedAmount ?? new BigNumber(0)).decimalPlaces(withdrawReserve.token.decimals, BigNumber.ROUND_DOWN);
 };
+export const getStrategyRebalanceDepositAmount = (
+// AppContext
+reserveMap, 
+// Strategy
+lstMap, strategyType, deposits, borrowedAmount) => {
+    const depositReserves = getStrategyDepositReserves(reserveMap, strategyType);
+    const depositReserve = (depositReserves.base ?? depositReserves.lst); // Must have LST if no base
+    const depositedAmount = deposits.find((d) => d.coinType === depositReserve.coinType)
+        ?.depositedAmount ?? new BigNumber(0);
+    if (depositedAmount.lte(0))
+        return new BigNumber(0);
+    const simulateWith = (newDepositedAmount) => getStrategySimulatedObligation(reserveMap, lstMap, strategyType, addOrInsertStrategyDeposit(deposits, {
+        coinType: depositReserve.coinType,
+        depositedAmount: newDepositedAmount.minus(depositedAmount),
+    }), borrowedAmount);
+    const withinMaxExposure = bisectionMethod(depositedAmount, depositedAmount.times(2), (n) => getStrategyExposure(reserveMap, lstMap, strategyType, simulateWith(n)).lte(STRATEGY_TYPE_EXPOSURE_MAP[strategyType].max));
+    const fullHealth = bisectionMethod(depositedAmount, depositedAmount.times(2), (n) => getStrategyHealthPercent(reserveMap, lstMap, strategyType, simulateWith(n)).eq(100));
+    return BigNumber.max(withinMaxExposure, fullHealth)
+        .minus(depositedAmount)
+        .decimalPlaces(depositReserve.token.decimals, BigNumber.ROUND_UP);
+};
 // Simulate
 export const strategySimulateLoopToExposure = (
 // AppContext
@@ -1236,7 +1259,7 @@ transaction, dryRunTransaction) => {
         _targetExposure: _targetExposure?.toFixed(20),
     }, null, 2));
     const depositReserve = (depositReserves.base ?? depositReserves.lst); // Must have LST if no base
-    const loopingDepositReserve = (depositReserves.lst ?? depositReserves.base); // Must have base if no LST
+    let loopingDepositReserve = (depositReserves.lst ?? depositReserves.base); // Must have base if no LST
     //
     let deposits = cloneDeep(_deposits);
     let borrowedAmount = _borrowedAmount;
@@ -1426,7 +1449,9 @@ transaction, dryRunTransaction) => {
             fullRepaymentAmount: fullRepaymentAmount.toFixed(20),
         }));
         // 1) MAX withdraw LST
-        if (depositReserves.lst !== undefined) {
+        if (depositReserves.lst !== undefined &&
+            (deposits.find((d) => d.coinType === depositReserves.lst.coinType)
+                ?.depositedAmount ?? new BigNumber(0)).gt(0)) {
             // 1.1) MAX withdraw
             const [withdrawnMaxLstCoin] = strategyWithdraw(strategyType, depositReserves.lst.coinType, strategyOwnerCapId, suilendClient.findReserveArrayIndex(depositReserves.lst.coinType), BigInt(MAX_U64.toString()), transaction);
             // 1.2) Update state
@@ -1585,9 +1610,10 @@ transaction, dryRunTransaction) => {
                 if (pendingBorrowedAmount.lt(0))
                     break; // Fully repaid already
                 if (depositReserve.coinType === depositReserves.base?.coinType) {
-                    const lstDeposit = deposits.find((d) => d.coinType === depositReserves.lst.coinType);
+                    const lstDepositedAmount = deposits.find((d) => d.coinType === depositReserves.lst.coinType)
+                        ?.depositedAmount ?? new BigNumber(0);
                     // Ran out of LST
-                    if (lstDeposit.depositedAmount.lte(STRATEGY_E)) {
+                    if (lstDepositedAmount.lte(STRATEGY_E)) {
                         // 1. MAX withdraws LST (transferred to user as SUI)
                         // 2. Withdraws base to cover borrows
                         // - Leftover transferred to user as borrow coinType, e.g. SUI or suiWBTC
@@ -1643,12 +1669,17 @@ transaction, dryRunTransaction) => {
             else {
                 if (pendingBorrowedAmount.lte(STRATEGY_E))
                     break;
+                // The rest of the debt is backed by base, so keep unwinding from it.
+                if (depositReserves.base !== undefined &&
+                    (deposits.find((d) => d.coinType === depositReserves.lst.coinType)
+                        ?.depositedAmount ?? new BigNumber(0)).lte(STRATEGY_E)) {
+                    loopingDepositReserve = depositReserves.base;
+                    continue;
+                }
             }
             // 1) Withdraw LST
             // 1.1) Max
-            const stepMaxWithdrawnAmount = getStrategyStepMaxWithdrawnAmount(reserveMap, lstMap, strategyType, deposits, borrowedAmount, loopingDepositReserve.coinType)
-                .times(0.9) // 10% buffer
-                .decimalPlaces(loopingDepositReserve.token.decimals, BigNumber.ROUND_DOWN);
+            const stepMaxWithdrawnAmount = getStrategyStepMaxWithdrawnAmount(reserveMap, lstMap, strategyType, deposits, borrowedAmount, loopingDepositReserve.coinType, 0.9);
             const stepMaxRepaidAmount = new BigNumber(new BigNumber(stepMaxWithdrawnAmount.times(lst?.lstToSuiExchangeRate ?? 1)).minus(getStrategyLstRedeemFee(lstMap, loopingDepositReserve.coinType, stepMaxWithdrawnAmount))).decimalPlaces(borrowReserve.token.decimals, BigNumber.ROUND_DOWN);
             console.log(`[unloopStrategyToExposure] ${i} withdraw_lst.max |`, JSON.stringify({
                 stepMaxWithdrawnAmount: stepMaxWithdrawnAmount.toFixed(20),
@@ -1785,9 +1816,7 @@ transaction, dryRunTransaction) => {
             }
             // 1) Withdraw base
             // 1.1) Max
-            const stepMaxWithdrawnAmount = getStrategyStepMaxWithdrawnAmount(reserveMap, lstMap, strategyType, deposits, borrowedAmount, loopingDepositReserve.coinType)
-                .times(0.9) // 10% buffer
-                .decimalPlaces(loopingDepositReserve.token.decimals, BigNumber.ROUND_DOWN);
+            const stepMaxWithdrawnAmount = getStrategyStepMaxWithdrawnAmount(reserveMap, lstMap, strategyType, deposits, borrowedAmount, loopingDepositReserve.coinType, 0.9);
             const stepMaxRepaidAmount = new BigNumber(stepMaxWithdrawnAmount.times(baseToBorrowExchangeRate)).decimalPlaces(borrowReserve.token.decimals, BigNumber.ROUND_DOWN);
             console.log(`[unloopStrategyToExposure] ${i} withdraw_base.max |`, JSON.stringify({
                 stepMaxWithdrawnAmount: stepMaxWithdrawnAmount.toFixed(20),
@@ -2351,6 +2380,17 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
     let borrowedAmount = _borrowedAmount;
     // 1) Unloop to 1x (base+LST: no LST and no borrows, LST: no borrows)
     if (borrowedAmount.gt(0)) {
+        // 1.0) Above the borrow limit no stepwise withdraw can land, so rebalance first
+        if (!isStrategyWithinBorrowLimit(reserveMap, lstMap, strategyType, deposits, borrowedAmount)) {
+            try {
+                ({ deposits, borrowedAmount, transaction } =
+                    await strategyRebalanceWithinBorrowLimitTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligationId, deposits, borrowedAmount, Transaction.from(transaction), dryRunTransaction));
+            }
+            catch (err) {
+                console.error(err);
+                throw new Error("Failed to repay borrows before withdrawing");
+            }
+        }
         // 1.1) Unloop
         const { deposits: newDeposits, borrowedAmount: newBorrowedAmount, transaction: newTransaction, } = await strategyUnloopToExposureTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligationId, deposits, borrowedAmount, undefined, // Don't pass targetBorrowedAmount
         new BigNumber(1), // Pass targetExposure
@@ -2373,6 +2413,30 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
     // rather than build a transaction that is certain to abort on the health check —
     // the caller can surface this instead of asking the user to sign it.
     let flashLoan;
+    let repaidByAdjustRepay = false;
+    if (borrowedAmount.gt(STRATEGY_E) &&
+        depositReserves.base !== undefined &&
+        depositReserves.lst !== undefined) {
+        const baseFlashLoanAmount = borrowedAmount
+            .times(1.01)
+            .decimalPlaces(borrowReserve.token.decimals, BigNumber.ROUND_UP)
+            .times(borrowReserve.price)
+            .div(depositReserves.base.price)
+            .times(1.03)
+            .decimalPlaces(depositReserves.base.token.decimals, BigNumber.ROUND_UP);
+        console.log(`[strategyMaxWithdraw] adjust_repay |`, JSON.stringify({
+            borrowedAmount: borrowedAmount.toFixed(20),
+            baseFlashLoanAmount: baseFlashLoanAmount.toFixed(20),
+        }));
+        try {
+            ({ deposits, borrowedAmount, transaction } = await strategyAdjustRepayTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligationId, deposits, borrowedAmount, baseFlashLoanAmount, Transaction.from(transaction), dryRunTransaction));
+        }
+        catch (err) {
+            console.error(err);
+            throw new Error("Failed to repay borrows before withdrawing");
+        }
+        repaidByAdjustRepay = true;
+    }
     if (borrowedAmount.gt(STRATEGY_E)) {
         const flashLoanObj = STRATEGY_TYPE_FLASH_LOAN_OBJ_MAP[strategyType];
         if (flashLoanObj.provider !== StrategyFlashLoanProvider.MMT ||
@@ -2525,7 +2589,7 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
             transaction = transactionBeforeClaim;
         }
     }
-    if (flashLoan !== undefined || borrowedAmount.gt(0)) {
+    if (flashLoan !== undefined || repaidByAdjustRepay || borrowedAmount.gt(0)) {
         try {
             await dryRunTransaction(transaction);
         }
@@ -2971,6 +3035,8 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
     }
     return { deposits, borrowedAmount, transaction };
 };
+const isStrategyWithinBorrowLimit = (reserveMap, lstMap, strategyType, deposits, borrowedAmount) => getStrategyHealthPercent(reserveMap, lstMap, strategyType, getStrategySimulatedObligation(reserveMap, lstMap, strategyType, deposits, borrowedAmount)).eq(100);
+const strategyRebalanceWithinBorrowLimitTx = (reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligationId, deposits, borrowedAmount, transaction, dryRunTransaction) => strategyDepositAdjustWithdrawTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligationId, deposits, borrowedAmount, getStrategyRebalanceDepositAmount(reserveMap, lstMap, strategyType, deposits, borrowedAmount), transaction, dryRunTransaction);
 export const strategyAdjustTx = async (
 // AppContext
 reserveMap, 
@@ -2983,7 +3049,7 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
     const depositReserves = getStrategyDepositReserves(reserveMap, strategyType);
     const borrowReserve = getStrategyBorrowReserve(reserveMap, strategyType);
     const defaultCurrencyReserve = getStrategyDefaultCurrencyReserve(reserveMap, strategyType);
-    const exposure = getStrategyExposure(reserveMap, lstMap, strategyType, obligation);
+    let exposure = getStrategyExposure(reserveMap, lstMap, strategyType, obligation);
     console.log(`[strategyAdjust] args |`, JSON.stringify({
         _address,
         strategyOwnerCapId,
@@ -2996,17 +3062,31 @@ lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _a
         targetExposure: targetExposure.toFixed(20),
     }, null, 2));
     //
-    const deposits = cloneDeep(_deposits);
-    const borrowedAmount = _borrowedAmount;
-    // 1) Loop or unloop to target exposure
+    let deposits = cloneDeep(_deposits);
+    let borrowedAmount = _borrowedAmount;
+    // 1) Above the borrow limit no stepwise withdraw can land, so rebalance first
+    const rebalanced = borrowedAmount.gt(0) && !isStrategyWithinBorrowLimit(reserveMap, lstMap, strategyType, deposits, borrowedAmount);
+    if (rebalanced) {
+        ({ deposits, borrowedAmount, transaction } =
+            await strategyRebalanceWithinBorrowLimitTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligation.id, deposits, borrowedAmount, transaction, dryRunTransaction));
+        exposure = getStrategyExposure(reserveMap, lstMap, strategyType, getStrategySimulatedObligation(reserveMap, lstMap, strategyType, deposits, borrowedAmount));
+    }
+    // 2) Loop or unloop to target exposure
+    let result;
     if (targetExposure.gt(exposure))
-        return strategyLoopToExposureTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligation.id, deposits, borrowedAmount, undefined, // Don't pass targetBorrowedAmount
+        result = await strategyLoopToExposureTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligation.id, deposits, borrowedAmount, undefined, // Don't pass targetBorrowedAmount
         targetExposure, // Pass targetExposure
         transaction);
     else if (targetExposure.lt(exposure))
-        return strategyUnloopToExposureTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligation.id, deposits, borrowedAmount, undefined, // Don't pass targetBorrowedAmount
+        result = await strategyUnloopToExposureTx(reserveMap, lstMap, strategyType, suiGrpcClient, suilendClient, cetusSdk, cetusPartnerId, _address, strategyOwnerCapId, obligation.id, deposits, borrowedAmount, undefined, // Don't pass targetBorrowedAmount
         targetExposure, // Pass targetExposure
         transaction, dryRunTransaction);
     else
         return { deposits, borrowedAmount, transaction };
+    if (result.borrowedAmount.eq(borrowedAmount)) {
+        if (rebalanced)
+            return { deposits, borrowedAmount, transaction };
+        throw new Error("Failed to adjust leverage");
+    }
+    return result;
 };