@suilend/sdk 12.7.0 → 13.0.0-next.g122801a

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

@@ -1,303 +1,897 @@
-import { PUBLISHED_AT } from "../index.js";
-import { generic, obj, pure } from "../../_framework/util.js";
-export function set(tx, typeArgs, args) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set`,
-        typeArguments: typeArgs,
+import { getPublishedAt } from '../../_envs/index.js';
+import { generic, obj, pure } from '../../_framework/util.js';
+/**
+ * Creates a new reserve configuration with the specified parameters.
+ *
+ * Validates the configuration to ensure it meets all required constraints before returning.
+ *
+ * # Arguments
+ *
+ * * `open_ltv_pct` - Loan-to-value percentage for opening positions (0-100).
+ * * `close_ltv_pct` - Loan-to-value percentage for closing positions (0-100).
+ * * `max_close_ltv_pct` - Maximum close LTV percentage (unused, 0-100).
+ * * `borrow_weight_bps` - Borrow weight in basis points (minimum 10,000).
+ * * `deposit_limit` - Maximum deposit amount in token units.
+ * * `borrow_limit` - Maximum borrow amount in token units.
+ * * `liquidation_bonus_bps` - Bonus for liquidators in basis points.
+ * * `max_liquidation_bonus_bps` - Maximum liquidation bonus in basis points (unused).
+ * * `deposit_limit_usd` - Maximum deposit amount in USD.
+ * * `borrow_limit_usd` - Maximum borrow amount in USD.
+ * * `borrow_fee_bps` - Fee for borrowing in basis points (maximum 10,000).
+ * * `spread_fee_bps` - Spread fee in basis points (maximum 10,000).
+ * * `protocol_liquidation_fee_bps` - Protocol fee on liquidations in basis points.
+ * * `interest_rate_utils` - Vector of utilization rates for interest rate calculation (0-100).
+ * * `interest_rate_aprs` - Vector of APRs corresponding to utilization rates.
+ * * `isolated` - If true, asset is isolated (can only be borrowed in isolation).
+ * * `open_attributed_borrow_limit_usd` - Open attributed borrow limit in USD (unused).
+ * * `close_attributed_borrow_limit_usd` - Close attributed borrow limit in USD (unused).
+ *
+ * # Returns
+ *
+ * * `ReserveConfig` - A validated reserve configuration.
+ *
+ * # Panics
+ *
+ * * If `open_ltv_pct`, `close_ltv_pct`, or `max_close_ltv_pct` exceeds 100 (`EInvalidReserveConfig`).
+ * * If `open_ltv_pct` is greater than `close_ltv_pct` (`EInvalidReserveConfig`).
+ * * If `close_ltv_pct` is greater than `max_close_ltv_pct` (`EInvalidReserveConfig`).
+ * * If `borrow_weight_bps` is less than 10,000 (`EInvalidReserveConfig`).
+ * * If `liquidation_bonus_bps` exceeds `max_liquidation_bonus_bps` (`EInvalidReserveConfig`).
+ * * If `liquidation_bonus_bps + protocol_liquidation_fee_bps` exceeds 2,000 (`EInvalidReserveConfig`).
+ * * If `isolated` is true and `open_ltv_pct` or `close_ltv_pct` is non-zero (`EInvalidReserveConfig`).
+ * * If `borrow_fee_bps` or `spread_fee_bps` exceeds 10,000 (`EInvalidReserveConfig`).
+ * * If `open_attributed_borrow_limit_usd` exceeds `close_attributed_borrow_limit_usd` (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` has fewer than 2 elements, does not start with 0, or end with 100 (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` and `interest_rate_aprs` have different lengths (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` is not strictly increasing or `interest_rate_aprs` is not monotonically increasing (`EInvalidReserveConfig`).
+ */
+export function createReserveConfig(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::create_reserve_config`,
         arguments: [
-            obj(tx, args.builder),
-            generic(tx, `${typeArgs[0]}`, args.field),
-            generic(tx, `${typeArgs[1]}`, args.value),
+            pure(tx, args.openLtvPct, `u8`),
+            pure(tx, args.closeLtvPct, `u8`),
+            pure(tx, args.maxCloseLtvPct, `u8`),
+            pure(tx, args.borrowWeightBps, `u64`),
+            pure(tx, args.depositLimit, `u64`),
+            pure(tx, args.borrowLimit, `u64`),
+            pure(tx, args.liquidationBonusBps, `u64`),
+            pure(tx, args.maxLiquidationBonusBps, `u64`),
+            pure(tx, args.depositLimitUsd, `u64`),
+            pure(tx, args.borrowLimitUsd, `u64`),
+            pure(tx, args.borrowFeeBps, `u64`),
+            pure(tx, args.spreadFeeBps, `u64`),
+            pure(tx, args.protocolLiquidationFeeBps, `u64`),
+            pure(tx, args.interestRateUtils, `vector<u8>`),
+            pure(tx, args.interestRateAprs, `vector<u64>`),
+            pure(tx, args.isolated, `bool`),
+            pure(tx, args.openAttributedBorrowLimitUsd, `u64`),
+            pure(tx, args.closeAttributedBorrowLimitUsd, `u64`),
         ],
     });
 }
-export function destroy(tx, config) {
+/**
+ * The raw basis-points value backing `confidence_multiplier`. Kept separate so `from()`
+ * can reseed a builder from the stored bps integer directly, rather than reconstructing
+ * it from the `Decimal` `confidence_multiplier` returns -- `decimal.move` has no reverse
+ * conversion back to bps.
+ */
+export function confidenceMultiplierBps(tx, config, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::destroy`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::confidence_multiplier_bps`,
         arguments: [obj(tx, config)],
     });
 }
-export function from(tx, config) {
+/**
+ * A confidence-margin multiplier `k`, stored in basis points (10_000 = 1x) and
+ * returned already scaled to a `Decimal`. It is intended to scale Pyth's raw
+ * confidence interval `conf` (same decimal exponent as the price):
+ * `price_lower_bound = min(spot, ema) - k * conf`,
+ * `price_upper_bound = max(spot, ema) + k * conf`.
+ * Zero (the default, and every reserve's value until explicitly set) means every
+ * valuation is bit-for-bit identical to before this field existed.
+ */
+export function confidenceMultiplier(tx, config, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::from`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::confidence_multiplier`,
         arguments: [obj(tx, config)],
     });
 }
-export function setSpreadFeeBps(tx, args) {
+/**
+ * Sets a reserve's confidence multiplier `k` (in basis points) on a config under
+ * construction, overwriting any existing value -- including removing the entry
+ * entirely when `confidence_multiplier_bps == 0`, so `confidence_multiplier` afterwards
+ * always reads back `decimal::from_bps(confidence_multiplier_bps)`.
+ */
+export function setConfidenceMultiplier(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_spread_fee_bps`,
-        arguments: [obj(tx, args.builder), pure(tx, args.spreadFeeBps, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_confidence_multiplier`,
+        arguments: [
+            obj(tx, args.config),
+            pure(tx, args.confidenceMultiplierBps, `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`,
+/**
+ * Shared by `set_confidence_multiplier`'s zero branch and `destroy()`, the two places
+ * a confidence-multiplier entry is ever dropped from a `Bag`.
+ */
+export function removeConfidenceMultiplierIfPresent(tx, bag, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::remove_confidence_multiplier_if_present`,
+        arguments: [obj(tx, bag)],
+    });
+}
+/**
+ * Validates the reserve configuration to ensure it meets all constraints.
+ *
+ * Checks various parameters for correctness, including LTVs, borrow weight, liquidation bonuses,
+ * fees, and interest rate vectors.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to validate.
+ *
+ * # Panics
+ *
+ * * If `open_ltv_pct`, `close_ltv_pct`, or `max_close_ltv_pct` exceeds 100 (`EInvalidReserveConfig`).
+ * * If `open_ltv_pct` is greater than `close_ltv_pct` (`EInvalidReserveConfig`).
+ * * If `close_ltv_pct` is greater than `max_close_ltv_pct` (`EInvalidReserveConfig`).
+ * * If `borrow_weight_bps` is less than 10,000 (`EInvalidReserveConfig`).
+ * * If `liquidation_bonus_bps` exceeds `max_liquidation_bonus_bps` (`EInvalidReserveConfig`).
+ * * If `liquidation_bonus_bps + protocol_liquidation_fee_bps` exceeds 2,000 (`EInvalidReserveConfig`).
+ * * If `isolated` is true and `open_ltv_pct` or `close_ltv_pct` is non-zero (`EInvalidReserveConfig`).
+ * * If `borrow_fee_bps` or `spread_fee_bps` exceeds 10,000 (`EInvalidReserveConfig`).
+ * * If `open_attributed_borrow_limit_usd` exceeds `close_attributed_borrow_limit_usd` (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` has fewer than 2 elements, does not start with 0, or end with 100 (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` and `interest_rate_aprs` have different lengths (`EInvalidReserveConfig`).
+ * * If `interest_rate_utils` is not strictly increasing or `interest_rate_aprs` is not monotonically increasing (`EInvalidReserveConfig`).
+ */
+export function validateReserveConfig(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::validate_reserve_config`,
+        arguments: [obj(tx, config)],
+    });
+}
+/**
+ * Validates the interest rate utilization and APR vectors.
+ *
+ * Ensures the utilization rates are strictly increasing, start at 0, end at 100, and
+ * match the length of the APR vector, which must be monotonically increasing.
+ *
+ * # Arguments
+ *
+ * * `utils` - A reference to the vector of utilization rates (0-100).
+ * * `aprs` - A reference to the vector of APRs in basis points.
+ *
+ * # Panics
+ *
+ * * If `utils` has fewer than 2 elements (`EInvalidReserveConfig`).
+ * * If `utils` and `aprs` have different lengths (`EInvalidReserveConfig`).
+ * * If `utils` does not start with 0 or end with 100 (`EInvalidReserveConfig`).
+ * * If `utils` is not strictly increasing (`EInvalidReserveConfig`).
+ * * If `aprs` is not monotonically increasing (`EInvalidReserveConfig`).
+ */
+export function validateUtilsAndAprs(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::validate_utils_and_aprs`,
         arguments: [
-            obj(tx, args.builder),
-            pure(tx, args.confidenceMultiplierBps, `u64`),
+            pure(tx, args.utils, `vector<u8>`),
+            pure(tx, args.aprs, `vector<u64>`),
         ],
     });
 }
-export function spreadFee(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::spread_fee`,
+/**
+ * Gets the open loan-to-value (LTV) ratio as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The open LTV ratio as a decimal (e.g., 50% = 0.5).
+ */
+export function openLtv(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::open_ltv`,
         arguments: [obj(tx, config)],
     });
 }
-export function borrowFee(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::borrow_fee`,
+/**
+ * Gets the close loan-to-value (LTV) ratio as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The close LTV ratio as a decimal (e.g., 50% = 0.5).
+ */
+export function closeLtv(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::close_ltv`,
         arguments: [obj(tx, config)],
     });
 }
-export function borrowLimit(tx, config) {
+export function openLtvPct(tx, config, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::borrow_limit`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::open_ltv_pct`,
         arguments: [obj(tx, config)],
     });
 }
-export function borrowLimitUsd(tx, config) {
+export function closeLtvPct(tx, config, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::borrow_limit_usd`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::close_ltv_pct`,
         arguments: [obj(tx, config)],
     });
 }
-export function borrowWeight(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::borrow_weight`,
+/**
+ * Gets the borrow weight as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The borrow weight as a decimal (e.g., 10,000 bps = 1.0).
+ */
+export function borrowWeight(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::borrow_weight`,
         arguments: [obj(tx, config)],
     });
 }
-export function build(tx, builder) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::build`,
-        arguments: [obj(tx, builder)],
+/**
+ * Gets the deposit limit in token units.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `u64` - The maximum deposit amount in token units.
+ */
+export function depositLimit(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::deposit_limit`,
+        arguments: [obj(tx, config)],
     });
 }
-export function calculateApr(tx, args) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::calculate_apr`,
-        arguments: [obj(tx, args.config), obj(tx, args.curUtil)],
+/**
+ * Gets the borrow limit in token units.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `u64` - The maximum borrow amount in token units.
+ */
+export function borrowLimit(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::borrow_limit`,
+        arguments: [obj(tx, config)],
     });
 }
-export function calculateSupplyApr(tx, args) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::calculate_supply_apr`,
-        arguments: [
-            obj(tx, args.config),
-            obj(tx, args.curUtil),
-            obj(tx, args.borrowApr),
-        ],
+/**
+ * Gets the liquidation bonus as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The liquidation bonus as a decimal (e.g., 500 bps = 0.05).
+ */
+export function liquidationBonus(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::liquidation_bonus`,
+        arguments: [obj(tx, config)],
     });
 }
-export function closeLtv(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::close_ltv`,
+/**
+ * Gets the deposit limit in USD.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `u64` - The maximum deposit amount in USD.
+ */
+export function depositLimitUsd(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::deposit_limit_usd`,
         arguments: [obj(tx, config)],
     });
 }
-export function createReserveConfig(tx, args) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::create_reserve_config`,
-        arguments: [
-            pure(tx, args.openLtvPct, `u8`),
-            pure(tx, args.closeLtvPct, `u8`),
-            pure(tx, args.maxCloseLtvPct, `u8`),
-            pure(tx, args.borrowWeightBps, `u64`),
-            pure(tx, args.depositLimit, `u64`),
-            pure(tx, args.borrowLimit, `u64`),
-            pure(tx, args.liquidationBonusBps, `u64`),
-            pure(tx, args.maxLiquidationBonusBps, `u64`),
-            pure(tx, args.depositLimitUsd, `u64`),
-            pure(tx, args.borrowLimitUsd, `u64`),
-            pure(tx, args.borrowFeeBps, `u64`),
-            pure(tx, args.spreadFeeBps, `u64`),
-            pure(tx, args.protocolLiquidationFeeBps, `u64`),
-            pure(tx, args.interestRateUtils, `vector<u8>`),
-            pure(tx, args.interestRateAprs, `vector<u64>`),
-            pure(tx, args.isolated, `bool`),
-            pure(tx, args.openAttributedBorrowLimitUsd, `u64`),
-            pure(tx, args.closeAttributedBorrowLimitUsd, `u64`),
-        ],
+/**
+ * Gets the borrow limit in USD.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `u64` - The maximum borrow amount in USD.
+ */
+export function borrowLimitUsd(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::borrow_limit_usd`,
+        arguments: [obj(tx, config)],
     });
 }
-export function depositLimit(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::deposit_limit`,
+/**
+ * Gets the borrow fee as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The borrow fee as a decimal (e.g., 10 bps = 0.001).
+ */
+export function borrowFee(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::borrow_fee`,
         arguments: [obj(tx, config)],
     });
 }
-export function depositLimitUsd(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::deposit_limit_usd`,
+/**
+ * Gets the protocol liquidation fee as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The protocol liquidation fee as a decimal (e.g., 300 bps = 0.03).
+ */
+export function protocolLiquidationFee(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::protocol_liquidation_fee`,
         arguments: [obj(tx, config)],
     });
 }
-export function isolated(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::isolated`,
+/**
+ * Gets the isolation status of the reserve.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `bool` - True if the asset is isolated, false otherwise.
+ */
+export function isolated(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::isolated`,
         arguments: [obj(tx, config)],
     });
 }
-export function liquidationBonus(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::liquidation_bonus`,
+/**
+ * Whether this reserve has been fully retired: no borrowing power, no liquidation value,
+ * and closed to new positions on both sides.
+ *
+ * This is deliberately STRICTER than `open_ltv == 0`. Zeroing open ltv alone is how a
+ * reserve is wound down while existing positions survive — the close ltv has to stay put,
+ * because zeroing it insta-liquidates every depositor. Such a reserve is still ordinary
+ * collateral, priced by a live feed, and worth real money. On MAIN as of 2026-08-18 the two
+ * groups are nothing alike: five wound-down reserves (wUSDC, wUSDT, AUSD, WETH, yapSUI) hold
+ * $133,635 backing $48,818 of live debt at close ltvs of 75-80%, while every fully retired
+ * reserve sits at close ltv 0.
+ *
+ * Retirement is therefore the honest test for "this deposit is not worth chasing": an
+ * operator only reaches this state once the asset backs nothing anyone can realize. Guards
+ * that ask what an obligation's collateral is WORTH use this; guards that only ask whether a
+ * deposit grants borrowing power use `open_ltv` directly.
+ *
+ * The off-chain twin is `mayUseOnChainPrice` in `common/utils/reservePriceFallback.ts`,
+ * which tests the same four fields and must keep agreeing with this.
+ */
+export function isRetired(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::is_retired`,
         arguments: [obj(tx, config)],
     });
 }
-export function openLtv(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::open_ltv`,
+/**
+ * Gets the spread fee as a decimal.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to query.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The spread fee as a decimal (e.g., 2000 bps = 0.2).
+ */
+export function spreadFee(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::spread_fee`,
         arguments: [obj(tx, config)],
     });
 }
-export function protocolLiquidationFee(tx, config) {
-    return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::protocol_liquidation_fee`,
+/**
+ * Calculates the annual percentage rate (APR) based on the current utilization.
+ *
+ * Interpolates the APR based on the utilization rate using the provided `interest_rate_utils`
+ * and `interest_rate_aprs` vectors.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` containing the interest rate data.
+ * * `cur_util` - The current utilization rate as a decimal (0 to 1).
+ *
+ * # Returns
+ *
+ * * `Decimal` - The calculated APR as a decimal.
+ *
+ * # Panics
+ *
+ * * If `cur_util` is greater than 1 (`EInvalidUtil`).
+ * * If the interpolation logic fails due to invalid configuration (`EInvalidReserveConfig`).
+ */
+export function calculateApr(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::calculate_apr`,
+        arguments: [
+            obj(tx, args.config),
+            obj(tx, args.curUtil),
+        ],
+    });
+}
+/**
+ * Calculates the supply APR based on the current utilization and borrow APR.
+ *
+ * Applies the spread fee to the borrow APR and scales it by the utilization rate.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` containing the spread fee.
+ * * `cur_util` - The current utilization rate as a decimal (0 to 1).
+ * * `borrow_apr` - The borrow APR as a decimal.
+ *
+ * # Returns
+ *
+ * * `Decimal` - The calculated supply APR as a decimal.
+ */
+export function calculateSupplyApr(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::calculate_supply_apr`,
+        arguments: [
+            obj(tx, args.config),
+            obj(tx, args.curUtil),
+            obj(tx, args.borrowApr),
+        ],
+    });
+}
+/**
+ * Destroys a reserve configuration, ensuring the additional fields bag is empty.
+ *
+ * # Arguments
+ *
+ * * `config` - The `ReserveConfig` to destroy.
+ *
+ * Drains the confidence multiplier from `additional_fields` before requiring it
+ * empty -- callers never need to remove it themselves first.
+ *
+ * # Panics
+ *
+ * * If `additional_fields` holds anything other than the confidence multiplier.
+ */
+export function destroy(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::destroy`,
         arguments: [obj(tx, config)],
     });
 }
-export function setBorrowFeeBps(tx, args) {
+/**
+ * Creates a new reserve configuration builder from an existing configuration.
+ *
+ * Initializes a `ReserveConfigBuilder` with the fields from the provided `ReserveConfig`.
+ *
+ * # Arguments
+ *
+ * * `config` - A reference to the `ReserveConfig` to initialize the builder from.
+ *
+ * # Returns
+ *
+ * * `ReserveConfigBuilder` - A new builder initialized with the config's fields.
+ */
+export function from(tx, config, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::from`,
+        arguments: [obj(tx, config)],
+    });
+}
+/**
+ * Sets the confidence multiplier `k` (in basis points) in the builder. Seeded
+ * automatically by `from` from the source config's current value, so
+ * `from(...) -> tweak -> build(...)` carries `k` forward the same way every other
+ * field already does.
+ */
+export function setConfidenceMultiplierBuilder(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_borrow_fee_bps`,
-        arguments: [obj(tx, args.builder), pure(tx, args.borrowFeeBps, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_confidence_multiplier_builder`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.confidenceMultiplierBps, `u64`),
+        ],
     });
 }
-export function setBorrowLimit(tx, args) {
+/**
+ * Sets a field in the reserve configuration builder.
+ *
+ * Updates an existing field or adds a new one to the builder's fields bag.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `field` - The key for the field to set.
+ * * `value` - The value to set for the field.
+ */
+export function set(tx, typeArgs, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set`,
+        typeArguments: typeArgs,
+        arguments: [
+            obj(tx, args.builder),
+            generic(tx, `${typeArgs[0]}`, args.field),
+            generic(tx, `${typeArgs[1]}`, args.value),
+        ],
+    });
+}
+export function upsert(tx, typeArgs, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_borrow_limit`,
-        arguments: [obj(tx, args.builder), pure(tx, args.borrowLimit, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::upsert`,
+        typeArguments: typeArgs,
+        arguments: [
+            obj(tx, args.bag),
+            generic(tx, `${typeArgs[0]}`, args.key),
+            generic(tx, `${typeArgs[1]}`, args.value),
+        ],
     });
 }
-export function setBorrowLimitUsd(tx, args) {
+/**
+ * Sets the open LTV percentage in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `open_ltv_pct` - The open LTV percentage to set.
+ */
+export function setOpenLtvPct(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_borrow_limit_usd`,
-        arguments: [obj(tx, args.builder), pure(tx, args.borrowLimitUsd, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_open_ltv_pct`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.openLtvPct, `u8`),
+        ],
     });
 }
-export function setBorrowWeightBps(tx, args) {
+/**
+ * Sets the close LTV percentage in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `close_ltv_pct` - The close LTV percentage to set.
+ */
+export function setCloseLtvPct(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_borrow_weight_bps`,
-        arguments: [obj(tx, args.builder), pure(tx, args.borrowWeightBps, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_close_ltv_pct`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.closeLtvPct, `u8`),
+        ],
     });
 }
-export function setCloseAttributedBorrowLimitUsd(tx, args) {
+/**
+ * Sets the maximum close LTV percentage in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `max_close_ltv_pct` - The maximum close LTV percentage to set.
+ */
+export function setMaxCloseLtvPct(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_close_attributed_borrow_limit_usd`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_max_close_ltv_pct`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.closeAttributedBorrowLimitUsd, `u64`),
+            pure(tx, args.maxCloseLtvPct, `u8`),
         ],
     });
 }
-export function setCloseLtvPct(tx, args) {
+/**
+ * Sets the borrow weight in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `borrow_weight_bps` - The borrow weight in basis points to set.
+ */
+export function setBorrowWeightBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_close_ltv_pct`,
-        arguments: [obj(tx, args.builder), pure(tx, args.closeLtvPct, `u8`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_borrow_weight_bps`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.borrowWeightBps, `u64`),
+        ],
     });
 }
-export function setDepositLimit(tx, args) {
+/**
+ * Sets the deposit limit in token units in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `deposit_limit` - The deposit limit in token units to set.
+ */
+export function setDepositLimit(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_deposit_limit`,
-        arguments: [obj(tx, args.builder), pure(tx, args.depositLimit, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_deposit_limit`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.depositLimit, `u64`),
+        ],
     });
 }
-export function setDepositLimitUsd(tx, args) {
+/**
+ * Sets the borrow limit in token units in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `borrow_limit` - The borrow limit in token units to set.
+ */
+export function setBorrowLimit(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_deposit_limit_usd`,
-        arguments: [obj(tx, args.builder), pure(tx, args.depositLimitUsd, `u64`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_borrow_limit`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.borrowLimit, `u64`),
+        ],
     });
 }
-export function setInterestRateAprs(tx, args) {
+/**
+ * Sets the liquidation bonus in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `liquidation_bonus_bps` - The liquidation bonus in basis points to set.
+ */
+export function setLiquidationBonusBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_interest_rate_aprs`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_liquidation_bonus_bps`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.interestRateAprs, `vector<u64>`),
+            pure(tx, args.liquidationBonusBps, `u64`),
         ],
     });
 }
-export function setInterestRateUtils(tx, args) {
+/**
+ * Sets the maximum liquidation bonus in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `max_liquidation_bonus_bps` - The maximum liquidation bonus in basis points to set.
+ */
+export function setMaxLiquidationBonusBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_interest_rate_utils`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_max_liquidation_bonus_bps`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.interestRateUtils, `vector<u8>`),
+            pure(tx, args.maxLiquidationBonusBps, `u64`),
         ],
     });
 }
-export function setIsolated(tx, args) {
+/**
+ * Sets the deposit limit in USD in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `deposit_limit_usd` - The deposit limit in USD to set.
+ */
+export function setDepositLimitUsd(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_isolated`,
-        arguments: [obj(tx, args.builder), pure(tx, args.isolated, `bool`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_deposit_limit_usd`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.depositLimitUsd, `u64`),
+        ],
     });
 }
-export function setLiquidationBonusBps(tx, args) {
+/**
+ * Sets the borrow limit in USD in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `borrow_limit_usd` - The borrow limit in USD to set.
+ */
+export function setBorrowLimitUsd(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_liquidation_bonus_bps`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_borrow_limit_usd`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.liquidationBonusBps, `u64`),
+            pure(tx, args.borrowLimitUsd, `u64`),
         ],
     });
 }
-export function setMaxCloseLtvPct(tx, args) {
+/**
+ * Sets the interest rate utilization vector in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `interest_rate_utils` - The vector of utilization rates to set.
+ */
+export function setInterestRateUtils(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_max_close_ltv_pct`,
-        arguments: [obj(tx, args.builder), pure(tx, args.maxCloseLtvPct, `u8`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_interest_rate_utils`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.interestRateUtils, `vector<u8>`),
+        ],
     });
 }
-export function setMaxLiquidationBonusBps(tx, args) {
+/**
+ * Sets the interest rate APR vector in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `interest_rate_aprs` - The vector of APRs to set.
+ */
+export function setInterestRateAprs(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_max_liquidation_bonus_bps`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_interest_rate_aprs`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.maxLiquidationBonusBps, `u64`),
+            pure(tx, args.interestRateAprs, `vector<u64>`),
         ],
     });
 }
-export function setOpenAttributedBorrowLimitUsd(tx, args) {
+/**
+ * Sets the borrow fee in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `borrow_fee_bps` - The borrow fee in basis points to set.
+ */
+export function setBorrowFeeBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_open_attributed_borrow_limit_usd`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_borrow_fee_bps`,
         arguments: [
             obj(tx, args.builder),
-            pure(tx, args.openAttributedBorrowLimitUsd, `u64`),
+            pure(tx, args.borrowFeeBps, `u64`),
         ],
     });
 }
-export function setOpenLtvPct(tx, args) {
+/**
+ * Sets the spread fee in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `spread_fee_bps` - The spread fee in basis points to set.
+ */
+export function setSpreadFeeBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_open_ltv_pct`,
-        arguments: [obj(tx, args.builder), pure(tx, args.openLtvPct, `u8`)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_spread_fee_bps`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.spreadFeeBps, `u64`),
+        ],
     });
 }
-export function setProtocolLiquidationFeeBps(tx, args) {
+/**
+ * Sets the protocol liquidation fee in basis points in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `protocol_liquidation_fee_bps` - The protocol liquidation fee in basis points to set.
+ */
+export function setProtocolLiquidationFeeBps(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::set_protocol_liquidation_fee_bps`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_protocol_liquidation_fee_bps`,
         arguments: [
             obj(tx, args.builder),
             pure(tx, args.protocolLiquidationFeeBps, `u64`),
         ],
     });
 }
-export function validateReserveConfig(tx, config) {
+/**
+ * Sets the isolation status in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `isolated` - The isolation status to set.
+ */
+export function setIsolated(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::validate_reserve_config`,
-        arguments: [obj(tx, config)],
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_isolated`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.isolated, `bool`),
+        ],
     });
 }
-export function validateUtilsAndAprs(tx, args) {
+/**
+ * Sets the open attributed borrow limit in USD in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `open_attributed_borrow_limit_usd` - The open attributed borrow limit in USD to set.
+ */
+export function setOpenAttributedBorrowLimitUsd(tx, args, options) {
     return tx.moveCall({
-        target: `${PUBLISHED_AT}::reserve_config::validate_utils_and_aprs`,
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_open_attributed_borrow_limit_usd`,
         arguments: [
-            pure(tx, args.utils, `vector<u8>`),
-            pure(tx, args.aprs, `vector<u64>`),
+            obj(tx, args.builder),
+            pure(tx, args.openAttributedBorrowLimitUsd, `u64`),
         ],
     });
 }
+/**
+ * Sets the close attributed borrow limit in USD in the builder.
+ *
+ * # Arguments
+ *
+ * * `builder` - A mutable reference to the `ReserveConfigBuilder`.
+ * * `close_attributed_borrow_limit_usd` - The close attributed borrow limit in USD to set.
+ */
+export function setCloseAttributedBorrowLimitUsd(tx, args, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::set_close_attributed_borrow_limit_usd`,
+        arguments: [
+            obj(tx, args.builder),
+            pure(tx, args.closeAttributedBorrowLimitUsd, `u64`),
+        ],
+    });
+}
+/**
+ * Builds a reserve configuration from the builder.
+ *
+ * Constructs a `ReserveConfig` by extracting all fields from the builder's bag and
+ * validating the resulting configuration.
+ *
+ * # Arguments
+ *
+ * * `builder` - The `ReserveConfigBuilder` to build from.
+ *
+ * # Returns
+ *
+ * * `ReserveConfig` - The constructed and validated reserve configuration.
+ *
+ * # Panics
+ *
+ * * If any required field is missing from the builder's bag.
+ * * If the constructed configuration fails validation (see `validate_reserve_config` for details).
+ */
+export function build(tx, builder, options) {
+    return tx.moveCall({
+        target: `${getPublishedAt('suilend', options?.env)}::reserve_config::build`,
+        arguments: [obj(tx, builder)],
+    });
+}