@kamino-finance/klend-sdk 7.4.0-beta.1 → 7.4.0-beta.3

package/src/@codegen/klend/types/ReserveConfig.ts

@@ -8,7 +8,7 @@ export interface ReserveConfigFields {
   /** Status of the reserve Active/Obsolete/Hidden */
   status: number
   /** Asset tier -> 0 - regular (collateral & debt), 1 - isolated collateral, 2 - isolated debt */
-  assetTier: number
+  paddingDeprecatedAssetTier: number
   /** Flat rate that goes to the host */
   hostFixedInterestRateBps: number
   /** Starting bonus for deleveraging-related liquidations, in bps. */
@@ -105,13 +105,30 @@ export interface ReserveConfigFields {
    * Only relevant when `autodeleverage_enabled == 1`, and must not be 0 in such case.
    */
   deleveragingBonusIncreaseBpsPerDay: BN
+  /**
+   * The timestamp at which all [Obligation::borrows] using this reserve become liquidatable
+   * (on the same terms as reserve-wide deleveraging).
+   * Inactive when zeroed (i.e. debt never matures).
+   *
+   * Note: this feature is independent of [Self::debt_term_seconds] - the liquidation mechanism
+   * is based directly on the timestamp defined here, on Reserve's level.
+   */
+  debtMaturityTimestamp: BN
+  /**
+   * The duration after which any debt coming from this Reserve must be repaid.
+   * Inactive when zeroed (i.e. funds can be borrowed indefinitely).
+   *
+   * Note: this feature is independent of [Self::debt_maturity_timestamp] - the liquidation
+   * mechanism is based on the [ObligationLiquidity::first_borrowed_at_timestamp].
+   */
+  debtTermSeconds: BN
 }
 
 export interface ReserveConfigJSON {
   /** Status of the reserve Active/Obsolete/Hidden */
   status: number
   /** Asset tier -> 0 - regular (collateral & debt), 1 - isolated collateral, 2 - isolated debt */
-  assetTier: number
+  paddingDeprecatedAssetTier: number
   /** Flat rate that goes to the host */
   hostFixedInterestRateBps: number
   /** Starting bonus for deleveraging-related liquidations, in bps. */
@@ -208,6 +225,23 @@ export interface ReserveConfigJSON {
    * Only relevant when `autodeleverage_enabled == 1`, and must not be 0 in such case.
    */
   deleveragingBonusIncreaseBpsPerDay: string
+  /**
+   * The timestamp at which all [Obligation::borrows] using this reserve become liquidatable
+   * (on the same terms as reserve-wide deleveraging).
+   * Inactive when zeroed (i.e. debt never matures).
+   *
+   * Note: this feature is independent of [Self::debt_term_seconds] - the liquidation mechanism
+   * is based directly on the timestamp defined here, on Reserve's level.
+   */
+  debtMaturityTimestamp: string
+  /**
+   * The duration after which any debt coming from this Reserve must be repaid.
+   * Inactive when zeroed (i.e. funds can be borrowed indefinitely).
+   *
+   * Note: this feature is independent of [Self::debt_maturity_timestamp] - the liquidation
+   * mechanism is based on the [ObligationLiquidity::first_borrowed_at_timestamp].
+   */
+  debtTermSeconds: string
 }
 
 /** Reserve configuration values */
@@ -215,7 +249,7 @@ export class ReserveConfig {
   /** Status of the reserve Active/Obsolete/Hidden */
   readonly status: number
   /** Asset tier -> 0 - regular (collateral & debt), 1 - isolated collateral, 2 - isolated debt */
-  readonly assetTier: number
+  readonly paddingDeprecatedAssetTier: number
   /** Flat rate that goes to the host */
   readonly hostFixedInterestRateBps: number
   /** Starting bonus for deleveraging-related liquidations, in bps. */
@@ -312,10 +346,27 @@ export class ReserveConfig {
    * Only relevant when `autodeleverage_enabled == 1`, and must not be 0 in such case.
    */
   readonly deleveragingBonusIncreaseBpsPerDay: BN
+  /**
+   * The timestamp at which all [Obligation::borrows] using this reserve become liquidatable
+   * (on the same terms as reserve-wide deleveraging).
+   * Inactive when zeroed (i.e. debt never matures).
+   *
+   * Note: this feature is independent of [Self::debt_term_seconds] - the liquidation mechanism
+   * is based directly on the timestamp defined here, on Reserve's level.
+   */
+  readonly debtMaturityTimestamp: BN
+  /**
+   * The duration after which any debt coming from this Reserve must be repaid.
+   * Inactive when zeroed (i.e. funds can be borrowed indefinitely).
+   *
+   * Note: this feature is independent of [Self::debt_maturity_timestamp] - the liquidation
+   * mechanism is based on the [ObligationLiquidity::first_borrowed_at_timestamp].
+   */
+  readonly debtTermSeconds: BN
 
   constructor(fields: ReserveConfigFields) {
     this.status = fields.status
-    this.assetTier = fields.assetTier
+    this.paddingDeprecatedAssetTier = fields.paddingDeprecatedAssetTier
     this.hostFixedInterestRateBps = fields.hostFixedInterestRateBps
     this.minDeleveragingBonusBps = fields.minDeleveragingBonusBps
     this.blockCtokenUsage = fields.blockCtokenUsage
@@ -358,13 +409,15 @@ export class ReserveConfig {
       fields.borrowLimitAgainstThisCollateralInElevationGroup
     this.deleveragingBonusIncreaseBpsPerDay =
       fields.deleveragingBonusIncreaseBpsPerDay
+    this.debtMaturityTimestamp = fields.debtMaturityTimestamp
+    this.debtTermSeconds = fields.debtTermSeconds
   }
 
   static layout(property?: string) {
     return borsh.struct(
       [
         borsh.u8("status"),
-        borsh.u8("assetTier"),
+        borsh.u8("paddingDeprecatedAssetTier"),
         borsh.u16("hostFixedInterestRateBps"),
         borsh.u16("minDeleveragingBonusBps"),
         borsh.u8("blockCtokenUsage"),
@@ -399,6 +452,8 @@ export class ReserveConfig {
           "borrowLimitAgainstThisCollateralInElevationGroup"
         ),
         borsh.u64("deleveragingBonusIncreaseBpsPerDay"),
+        borsh.u64("debtMaturityTimestamp"),
+        borsh.u64("debtTermSeconds"),
       ],
       property
     )
@@ -408,7 +463,7 @@ export class ReserveConfig {
   static fromDecoded(obj: any) {
     return new ReserveConfig({
       status: obj.status,
-      assetTier: obj.assetTier,
+      paddingDeprecatedAssetTier: obj.paddingDeprecatedAssetTier,
       hostFixedInterestRateBps: obj.hostFixedInterestRateBps,
       minDeleveragingBonusBps: obj.minDeleveragingBonusBps,
       blockCtokenUsage: obj.blockCtokenUsage,
@@ -447,13 +502,15 @@ export class ReserveConfig {
         obj.borrowLimitAgainstThisCollateralInElevationGroup,
       deleveragingBonusIncreaseBpsPerDay:
         obj.deleveragingBonusIncreaseBpsPerDay,
+      debtMaturityTimestamp: obj.debtMaturityTimestamp,
+      debtTermSeconds: obj.debtTermSeconds,
     })
   }
 
   static toEncodable(fields: ReserveConfigFields) {
     return {
       status: fields.status,
-      assetTier: fields.assetTier,
+      paddingDeprecatedAssetTier: fields.paddingDeprecatedAssetTier,
       hostFixedInterestRateBps: fields.hostFixedInterestRateBps,
       minDeleveragingBonusBps: fields.minDeleveragingBonusBps,
       blockCtokenUsage: fields.blockCtokenUsage,
@@ -494,13 +551,15 @@ export class ReserveConfig {
         fields.borrowLimitAgainstThisCollateralInElevationGroup,
       deleveragingBonusIncreaseBpsPerDay:
         fields.deleveragingBonusIncreaseBpsPerDay,
+      debtMaturityTimestamp: fields.debtMaturityTimestamp,
+      debtTermSeconds: fields.debtTermSeconds,
     }
   }
 
   toJSON(): ReserveConfigJSON {
     return {
       status: this.status,
-      assetTier: this.assetTier,
+      paddingDeprecatedAssetTier: this.paddingDeprecatedAssetTier,
       hostFixedInterestRateBps: this.hostFixedInterestRateBps,
       minDeleveragingBonusBps: this.minDeleveragingBonusBps,
       blockCtokenUsage: this.blockCtokenUsage,
@@ -539,13 +598,15 @@ export class ReserveConfig {
         ),
       deleveragingBonusIncreaseBpsPerDay:
         this.deleveragingBonusIncreaseBpsPerDay.toString(),
+      debtMaturityTimestamp: this.debtMaturityTimestamp.toString(),
+      debtTermSeconds: this.debtTermSeconds.toString(),
     }
   }
 
   static fromJSON(obj: ReserveConfigJSON): ReserveConfig {
     return new ReserveConfig({
       status: obj.status,
-      assetTier: obj.assetTier,
+      paddingDeprecatedAssetTier: obj.paddingDeprecatedAssetTier,
       hostFixedInterestRateBps: obj.hostFixedInterestRateBps,
       minDeleveragingBonusBps: obj.minDeleveragingBonusBps,
       blockCtokenUsage: obj.blockCtokenUsage,
@@ -590,6 +651,8 @@ export class ReserveConfig {
       deleveragingBonusIncreaseBpsPerDay: new BN(
         obj.deleveragingBonusIncreaseBpsPerDay
       ),
+      debtMaturityTimestamp: new BN(obj.debtMaturityTimestamp),
+      debtTermSeconds: new BN(obj.debtTermSeconds),
     })
   }
 

package/src/@codegen/klend/types/ReserveLiquidity.ts

@@ -11,8 +11,14 @@ export interface ReserveLiquidityFields {
   supplyVault: Address
   /** Reserve liquidity fee collection address */
   feeVault: Address
-  /** Reserve liquidity available */
-  availableAmount: BN
+  /**
+   * Total reserve liquidity available.
+   *
+   * Note: not all of this liquidity can be freely used for any purpose. Production code should
+   * use the specialized getters - see e.g. [Reserve::total_available_liquidity_amount()],
+   * [Reserve::freely_available_liquidity_amount()].
+   */
+  totalAvailableAmount: BN
   /** Reserve liquidity borrowed (scaled fraction) */
   borrowedAmountSf: BN
   /** Reserve liquidity market price in quote currency (scaled fraction) */
@@ -54,8 +60,14 @@ export interface ReserveLiquidityJSON {
   supplyVault: string
   /** Reserve liquidity fee collection address */
   feeVault: string
-  /** Reserve liquidity available */
-  availableAmount: string
+  /**
+   * Total reserve liquidity available.
+   *
+   * Note: not all of this liquidity can be freely used for any purpose. Production code should
+   * use the specialized getters - see e.g. [Reserve::total_available_liquidity_amount()],
+   * [Reserve::freely_available_liquidity_amount()].
+   */
+  totalAvailableAmount: string
   /** Reserve liquidity borrowed (scaled fraction) */
   borrowedAmountSf: string
   /** Reserve liquidity market price in quote currency (scaled fraction) */
@@ -98,8 +110,14 @@ export class ReserveLiquidity {
   readonly supplyVault: Address
   /** Reserve liquidity fee collection address */
   readonly feeVault: Address
-  /** Reserve liquidity available */
-  readonly availableAmount: BN
+  /**
+   * Total reserve liquidity available.
+   *
+   * Note: not all of this liquidity can be freely used for any purpose. Production code should
+   * use the specialized getters - see e.g. [Reserve::total_available_liquidity_amount()],
+   * [Reserve::freely_available_liquidity_amount()].
+   */
+  readonly totalAvailableAmount: BN
   /** Reserve liquidity borrowed (scaled fraction) */
   readonly borrowedAmountSf: BN
   /** Reserve liquidity market price in quote currency (scaled fraction) */
@@ -137,7 +155,7 @@ export class ReserveLiquidity {
     this.mintPubkey = fields.mintPubkey
     this.supplyVault = fields.supplyVault
     this.feeVault = fields.feeVault
-    this.availableAmount = fields.availableAmount
+    this.totalAvailableAmount = fields.totalAvailableAmount
     this.borrowedAmountSf = fields.borrowedAmountSf
     this.marketPriceSf = fields.marketPriceSf
     this.marketPriceLastUpdatedTs = fields.marketPriceLastUpdatedTs
@@ -162,7 +180,7 @@ export class ReserveLiquidity {
         borshAddress("mintPubkey"),
         borshAddress("supplyVault"),
         borshAddress("feeVault"),
-        borsh.u64("availableAmount"),
+        borsh.u64("totalAvailableAmount"),
         borsh.u128("borrowedAmountSf"),
         borsh.u128("marketPriceSf"),
         borsh.u64("marketPriceLastUpdatedTs"),
@@ -188,7 +206,7 @@ export class ReserveLiquidity {
       mintPubkey: obj.mintPubkey,
       supplyVault: obj.supplyVault,
       feeVault: obj.feeVault,
-      availableAmount: obj.availableAmount,
+      totalAvailableAmount: obj.totalAvailableAmount,
       borrowedAmountSf: obj.borrowedAmountSf,
       marketPriceSf: obj.marketPriceSf,
       marketPriceLastUpdatedTs: obj.marketPriceLastUpdatedTs,
@@ -213,7 +231,7 @@ export class ReserveLiquidity {
       mintPubkey: fields.mintPubkey,
       supplyVault: fields.supplyVault,
       feeVault: fields.feeVault,
-      availableAmount: fields.availableAmount,
+      totalAvailableAmount: fields.totalAvailableAmount,
       borrowedAmountSf: fields.borrowedAmountSf,
       marketPriceSf: fields.marketPriceSf,
       marketPriceLastUpdatedTs: fields.marketPriceLastUpdatedTs,
@@ -238,7 +256,7 @@ export class ReserveLiquidity {
       mintPubkey: this.mintPubkey,
       supplyVault: this.supplyVault,
       feeVault: this.feeVault,
-      availableAmount: this.availableAmount.toString(),
+      totalAvailableAmount: this.totalAvailableAmount.toString(),
       borrowedAmountSf: this.borrowedAmountSf.toString(),
       marketPriceSf: this.marketPriceSf.toString(),
       marketPriceLastUpdatedTs: this.marketPriceLastUpdatedTs.toString(),
@@ -262,7 +280,7 @@ export class ReserveLiquidity {
       mintPubkey: address(obj.mintPubkey),
       supplyVault: address(obj.supplyVault),
       feeVault: address(obj.feeVault),
-      availableAmount: new BN(obj.availableAmount),
+      totalAvailableAmount: new BN(obj.totalAvailableAmount),
       borrowedAmountSf: new BN(obj.borrowedAmountSf),
       marketPriceSf: new BN(obj.marketPriceSf),
       marketPriceLastUpdatedTs: new BN(obj.marketPriceLastUpdatedTs),

package/src/@codegen/klend/types/UpdateConfigMode.ts

@@ -556,25 +556,25 @@ export class UpdateBorrowRateCurve {
   }
 }
 
-export interface UpdateEntireReserveConfigJSON {
-  kind: "UpdateEntireReserveConfig"
+export interface DeprecatedUpdateEntireReserveConfigJSON {
+  kind: "DeprecatedUpdateEntireReserveConfig"
 }
 
-export class UpdateEntireReserveConfig {
+export class DeprecatedUpdateEntireReserveConfig {
   static readonly discriminator = 24
-  static readonly kind = "UpdateEntireReserveConfig"
+  static readonly kind = "DeprecatedUpdateEntireReserveConfig"
   readonly discriminator = 24
-  readonly kind = "UpdateEntireReserveConfig"
+  readonly kind = "DeprecatedUpdateEntireReserveConfig"
 
-  toJSON(): UpdateEntireReserveConfigJSON {
+  toJSON(): DeprecatedUpdateEntireReserveConfigJSON {
     return {
-      kind: "UpdateEntireReserveConfig",
+      kind: "DeprecatedUpdateEntireReserveConfig",
     }
   }
 
   toEncodable() {
     return {
-      UpdateEntireReserveConfig: {},
+      DeprecatedUpdateEntireReserveConfig: {},
     }
   }
 }
@@ -763,25 +763,25 @@ export class UpdateBorrowFactor {
   }
 }
 
-export interface UpdateAssetTierJSON {
-  kind: "UpdateAssetTier"
+export interface DeprecatedUpdateAssetTierJSON {
+  kind: "DeprecatedUpdateAssetTier"
 }
 
-export class UpdateAssetTier {
+export class DeprecatedUpdateAssetTier {
   static readonly discriminator = 33
-  static readonly kind = "UpdateAssetTier"
+  static readonly kind = "DeprecatedUpdateAssetTier"
   readonly discriminator = 33
-  readonly kind = "UpdateAssetTier"
+  readonly kind = "DeprecatedUpdateAssetTier"
 
-  toJSON(): UpdateAssetTierJSON {
+  toJSON(): DeprecatedUpdateAssetTierJSON {
     return {
-      kind: "UpdateAssetTier",
+      kind: "DeprecatedUpdateAssetTier",
     }
   }
 
   toEncodable() {
     return {
-      UpdateAssetTier: {},
+      DeprecatedUpdateAssetTier: {},
     }
   }
 }
@@ -1223,6 +1223,52 @@ export class UpdateBlockCTokenUsage {
   }
 }
 
+export interface UpdateDebtMaturityTimestampJSON {
+  kind: "UpdateDebtMaturityTimestamp"
+}
+
+export class UpdateDebtMaturityTimestamp {
+  static readonly discriminator = 53
+  static readonly kind = "UpdateDebtMaturityTimestamp"
+  readonly discriminator = 53
+  readonly kind = "UpdateDebtMaturityTimestamp"
+
+  toJSON(): UpdateDebtMaturityTimestampJSON {
+    return {
+      kind: "UpdateDebtMaturityTimestamp",
+    }
+  }
+
+  toEncodable() {
+    return {
+      UpdateDebtMaturityTimestamp: {},
+    }
+  }
+}
+
+export interface UpdateDebtTermSecondsJSON {
+  kind: "UpdateDebtTermSeconds"
+}
+
+export class UpdateDebtTermSeconds {
+  static readonly discriminator = 54
+  static readonly kind = "UpdateDebtTermSeconds"
+  readonly discriminator = 54
+  readonly kind = "UpdateDebtTermSeconds"
+
+  toJSON(): UpdateDebtTermSecondsJSON {
+    return {
+      kind: "UpdateDebtTermSeconds",
+    }
+  }
+
+  toEncodable() {
+    return {
+      UpdateDebtTermSeconds: {},
+    }
+  }
+}
+
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function fromDecoded(obj: any): types.UpdateConfigModeKind {
   if (typeof obj !== "object") {
@@ -1301,8 +1347,8 @@ export function fromDecoded(obj: any): types.UpdateConfigModeKind {
   if ("UpdateBorrowRateCurve" in obj) {
     return new UpdateBorrowRateCurve()
   }
-  if ("UpdateEntireReserveConfig" in obj) {
-    return new UpdateEntireReserveConfig()
+  if ("DeprecatedUpdateEntireReserveConfig" in obj) {
+    return new DeprecatedUpdateEntireReserveConfig()
   }
   if ("UpdateDebtWithdrawalCap" in obj) {
     return new UpdateDebtWithdrawalCap()
@@ -1328,8 +1374,8 @@ export function fromDecoded(obj: any): types.UpdateConfigModeKind {
   if ("UpdateBorrowFactor" in obj) {
     return new UpdateBorrowFactor()
   }
-  if ("UpdateAssetTier" in obj) {
-    return new UpdateAssetTier()
+  if ("DeprecatedUpdateAssetTier" in obj) {
+    return new DeprecatedUpdateAssetTier()
   }
   if ("UpdateElevationGroup" in obj) {
     return new UpdateElevationGroup()
@@ -1388,6 +1434,12 @@ export function fromDecoded(obj: any): types.UpdateConfigModeKind {
   if ("UpdateBlockCTokenUsage" in obj) {
     return new UpdateBlockCTokenUsage()
   }
+  if ("UpdateDebtMaturityTimestamp" in obj) {
+    return new UpdateDebtMaturityTimestamp()
+  }
+  if ("UpdateDebtTermSeconds" in obj) {
+    return new UpdateDebtTermSeconds()
+  }
 
   throw new Error("Invalid enum object")
 }
@@ -1468,8 +1520,8 @@ export function fromJSON(
     case "UpdateBorrowRateCurve": {
       return new UpdateBorrowRateCurve()
     }
-    case "UpdateEntireReserveConfig": {
-      return new UpdateEntireReserveConfig()
+    case "DeprecatedUpdateEntireReserveConfig": {
+      return new DeprecatedUpdateEntireReserveConfig()
     }
     case "UpdateDebtWithdrawalCap": {
       return new UpdateDebtWithdrawalCap()
@@ -1495,8 +1547,8 @@ export function fromJSON(
     case "UpdateBorrowFactor": {
       return new UpdateBorrowFactor()
     }
-    case "UpdateAssetTier": {
-      return new UpdateAssetTier()
+    case "DeprecatedUpdateAssetTier": {
+      return new DeprecatedUpdateAssetTier()
     }
     case "UpdateElevationGroup": {
       return new UpdateElevationGroup()
@@ -1555,6 +1607,12 @@ export function fromJSON(
     case "UpdateBlockCTokenUsage": {
       return new UpdateBlockCTokenUsage()
     }
+    case "UpdateDebtMaturityTimestamp": {
+      return new UpdateDebtMaturityTimestamp()
+    }
+    case "UpdateDebtTermSeconds": {
+      return new UpdateDebtTermSeconds()
+    }
   }
 }
 
@@ -1584,7 +1642,7 @@ export function layout(property?: string) {
     borsh.struct([], "UpdateSwitchboardFeed"),
     borsh.struct([], "UpdateSwitchboardTwapFeed"),
     borsh.struct([], "UpdateBorrowRateCurve"),
-    borsh.struct([], "UpdateEntireReserveConfig"),
+    borsh.struct([], "DeprecatedUpdateEntireReserveConfig"),
     borsh.struct([], "UpdateDebtWithdrawalCap"),
     borsh.struct([], "UpdateDepositWithdrawalCap"),
     borsh.struct([], "DeprecatedUpdateDebtWithdrawalCapCurrentTotal"),
@@ -1593,7 +1651,7 @@ export function layout(property?: string) {
     borsh.struct([], "UpdateMinLiquidationBonusBps"),
     borsh.struct([], "UpdateDeleveragingMarginCallPeriod"),
     borsh.struct([], "UpdateBorrowFactor"),
-    borsh.struct([], "UpdateAssetTier"),
+    borsh.struct([], "DeprecatedUpdateAssetTier"),
     borsh.struct([], "UpdateElevationGroup"),
     borsh.struct([], "UpdateDeleveragingThresholdDecreaseBpsPerDay"),
     borsh.struct([], "DeprecatedUpdateMultiplierSideBoost"),
@@ -1613,6 +1671,8 @@ export function layout(property?: string) {
     borsh.struct([], "UpdateProposerAuthorityLock"),
     borsh.struct([], "UpdateMinDeleveragingBonusBps"),
     borsh.struct([], "UpdateBlockCTokenUsage"),
+    borsh.struct([], "UpdateDebtMaturityTimestamp"),
+    borsh.struct([], "UpdateDebtTermSeconds"),
   ])
   if (property !== undefined) {
     return ret.replicate(property)