@kamino-finance/klend-sdk 7.4.0-beta.5 → 7.4.0-beta.6

package/dist/idl/klend.json

@@ -1,5 +1,5 @@
 {
-    "version": "1.13.1",
+    "version": "1.13.2",
     "name": "kamino_lending",
     "instructions": [
         {
@@ -3051,6 +3051,201 @@
                 }
             ]
         },
+        {
+            "name": "updateObligationConfig",
+            "accounts": [
+                {
+                    "name": "owner",
+                    "isMut": false,
+                    "isSigner": true,
+                    "docs": [
+                        "Obligation's owner (signer - only the owner can modify the obligation's configuration)."
+                    ]
+                },
+                {
+                    "name": "obligation",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The obligation to update."
+                    ]
+                },
+                {
+                    "name": "borrowReserve",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The reserve of a selected one among the [Obligation::borrows].",
+                        "",
+                        "Required only if the config update affects a single borrow (for validating its new config)."
+                    ]
+                },
+                {
+                    "name": "depositReserve",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The reserve of a selected one among the [Obligation::deposits].",
+                        "",
+                        "Required only if the config update affects a single deposit (for validating its new config)."
+                    ]
+                },
+                {
+                    "name": "lendingMarket",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The lending market (for validating the obligation's new config)."
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "mode",
+                    "type": {
+                        "defined": "UpdateObligationConfigMode"
+                    }
+                },
+                {
+                    "name": "value",
+                    "type": "bytes"
+                }
+            ]
+        },
+        {
+            "name": "rolloverFixedTermBorrow",
+            "accounts": [
+                {
+                    "name": "rolloverAccounts",
+                    "accounts": [
+                        {
+                            "name": "payer",
+                            "isMut": false,
+                            "isSigner": true
+                        },
+                        {
+                            "name": "obligation",
+                            "isMut": true,
+                            "isSigner": false,
+                            "docs": [
+                                "The obligation with a fixed-term borrow."
+                            ]
+                        },
+                        {
+                            "name": "lendingMarket",
+                            "isMut": false,
+                            "isSigner": false,
+                            "docs": [
+                                "The [Self::obligation]'s market, needed for validations against the market-wide",
+                                "configuration."
+                            ]
+                        },
+                        {
+                            "name": "lendingMarketAuthority",
+                            "isMut": false,
+                            "isSigner": false,
+                            "docs": [
+                                "The [Self::lending_market]'s authority, needed to transfer the newly-borrowed funds out of",
+                                "the [Self::reserve_source_liquidity]."
+                            ]
+                        },
+                        {
+                            "name": "sourceBorrowReserve",
+                            "isMut": true,
+                            "isSigner": false,
+                            "docs": [
+                                "The fixed-term reserve used by the existing [Self::obligation]'s borrow that approaches its",
+                                "debt term and needs to rollover from."
+                            ]
+                        },
+                        {
+                            "name": "targetBorrowReserve",
+                            "isMut": true,
+                            "isSigner": false,
+                            "docs": [
+                                "The reserve to rollover the borrow into - possibly (but not necessarily) the same as",
+                                "[Self::source_borrow_reserve]'s (but definitely of the same liquidity mint)."
+                            ]
+                        },
+                        {
+                            "name": "liquidityMint",
+                            "isMut": false,
+                            "isSigner": false,
+                            "docs": [
+                                "The mint of [Self::source_borrow_reserve] and [Self::target_borrow_reserve], needed to",
+                                "transfer funds between them."
+                            ]
+                        },
+                        {
+                            "name": "sourceBorrowReserveLiquidity",
+                            "isMut": true,
+                            "isSigner": false,
+                            "docs": [
+                                "The vault of [Self::source_borrow_reserve], from which the funds are transferred."
+                            ]
+                        },
+                        {
+                            "name": "targetBorrowReserveLiquidity",
+                            "isMut": true,
+                            "isSigner": false,
+                            "docs": [
+                                "The vault of [Self::target_borrow_reserve], from which the funds are transferred."
+                            ]
+                        },
+                        {
+                            "name": "tokenProgram",
+                            "isMut": false,
+                            "isSigner": false,
+                            "docs": [
+                                "The token program of [Self::liquidity_mint] - needed to execute the transfer."
+                            ]
+                        }
+                    ]
+                },
+                {
+                    "name": "sourceFarmsAccounts",
+                    "accounts": [
+                        {
+                            "name": "obligationFarmUserState",
+                            "isMut": true,
+                            "isSigner": false,
+                            "isOptional": true
+                        },
+                        {
+                            "name": "reserveFarmState",
+                            "isMut": true,
+                            "isSigner": false,
+                            "isOptional": true
+                        }
+                    ]
+                },
+                {
+                    "name": "targetFarmsAccounts",
+                    "accounts": [
+                        {
+                            "name": "obligationFarmUserState",
+                            "isMut": true,
+                            "isSigner": false,
+                            "isOptional": true
+                        },
+                        {
+                            "name": "reserveFarmState",
+                            "isMut": true,
+                            "isSigner": false,
+                            "isOptional": true
+                        }
+                    ]
+                },
+                {
+                    "name": "farmsProgram",
+                    "isMut": false,
+                    "isSigner": false
+                }
+            ],
+            "args": []
+        },
         {
             "name": "fillBorrowOrder",
             "accounts": [
@@ -4185,8 +4380,8 @@
                             "Whether the owners can enable the \"fixed term borrow rollover\" on their obligations.",
                             "",
                             "*Note 1:* the actual execution of (different kinds of) rollovers can be disabled by zeroing",
-                            "[Self::fixed_rollover_window_duration_seconds] and",
-                            "[Self::variable_rollover_window_duration_seconds].",
+                            "[Self::fixed_term_rollover_window_duration_seconds] and",
+                            "[Self::open_term_rollover_window_duration_seconds].",
                             "",
                             "*Note 2:* when this configuration is disabled, the obligation owners can still disable their",
                             "rollover (i.e. set the obligation's flags to zeroes)."
@@ -4211,7 +4406,7 @@
                         "type": "u64"
                     },
                     {
-                        "name": "fixedRolloverWindowDurationSeconds",
+                        "name": "fixedTermRolloverWindowDurationSeconds",
                         "docs": [
                             "A configurable time window (right before the end of a fixed debt term) during which an",
                             "auto-rollover into another *fixed* rate/term can happen.",
@@ -4223,15 +4418,15 @@
                         "type": "u64"
                     },
                     {
-                        "name": "variableRolloverWindowDurationSeconds",
+                        "name": "openTermRolloverWindowDurationSeconds",
                         "docs": [
                             "A configurable time window (right before the end of a fixed debt term) during which an",
                             "auto-rollover into a *variable* (indefinite) rate/term can happen.",
                             "",
                             "When zeroed, this rollover mode is effectively disabled.",
                             "",
-                            "This will typically be shorter than [Self::fixed_rollover_window_duration_seconds], acting",
-                            "as a fallback if a fixed reserve liquidity remains unavailable for considerable time."
+                            "This will typically be shorter than [Self::fixed_term_rollover_window_duration_seconds],",
+                            "acting as a fallback if a fixed reserve liquidity remains unavailable for considerable time."
                         ],
                         "type": "u64"
                     },
@@ -4906,6 +5101,10 @@
                     {
                         "name": "fillableUntilTimestamp",
                         "type": "u64"
+                    },
+                    {
+                        "name": "enableAutoRolloverOnFilledBorrows",
+                        "type": "bool"
                     }
                 ]
             }
@@ -5265,10 +5464,10 @@
                         "name": "UpdateMinWithdrawQueuedLiquidityValue"
                     },
                     {
-                        "name": "UpdateFixedRolloverWindowDurationSeconds"
+                        "name": "UpdateFixedTermRolloverWindowDurationSeconds"
                     },
                     {
-                        "name": "UpdateVariableRolloverWindowDurationSeconds"
+                        "name": "UpdateOpenTermRolloverWindowDurationSeconds"
                     },
                     {
                         "name": "UpdateObligationBorrowRolloverConfigurationEnabled"
@@ -5470,6 +5669,29 @@
                         ],
                         "type": "u32"
                     },
+                    {
+                        "name": "enableAutoRolloverOnFilledBorrows",
+                        "docs": [
+                            "When `1`, all [Obligation::borrows] that get filled by this order will have their",
+                            "[FixedTermBorrowRolloverConfig::auto_rollover_enabled] flag set.",
+                            "",
+                            "Additionally, their rollover customizations:",
+                            "- will exactly match this order's constraints regarding [Self::min_debt_term_seconds] and",
+                            "[Self::max_borrow_rate_bps];",
+                            "- will use the [FixedTermBorrowRolloverConfig::open_term_allowed] fallback.",
+                            "",
+                            "See [BorrowOrder::get_rollover_config_for_filled_borrow()].",
+                            "",
+                            "Clarification note: when `0`, this setting has no effect on any borrow (i.e. if an existing",
+                            "borrow was independently marked for auto-rollover, it will *not* be unmarked when filled by",
+                            "this order).",
+                            "",
+                            "Feature flag note: when [LendingMarket::obligation_borrow_rollover_configuration_enabled] is",
+                            "disabled, this setting has no effect on any borrow (i.e. the fill will be successful, but",
+                            "the borrow will not be marked for auto-rollover."
+                        ],
+                        "type": "u8"
+                    },
                     {
                         "name": "padding1",
                         "docs": [
@@ -5478,7 +5700,7 @@
                         "type": {
                             "array": [
                                 "u8",
-                                4
+                                3
                             ]
                         }
                     },
@@ -5519,7 +5741,7 @@
                             "C) sufficient available liquidity (including no withdraw tickets waiting in its queue).",
                             "",
                             "The time left until the current debt term expires must be:",
-                            "D) less than [LendingMarket::fixed_rollover_window_duration_seconds].",
+                            "D) less than [LendingMarket::fixed_term_rollover_window_duration_seconds].",
                             "",
                             "Note: the other settings are only effective when this one is `1`."
                         ],
@@ -5530,7 +5752,7 @@
                         "docs": [
                             "When `1`, partially lifts the condition *B* from [Self::auto_rollover_enabled]: additionally",
                             "allows to use a variable (indefinite) debt term if less than",
-                            "[LendingMarket::variable_rollover_window_duration_seconds] is left until expiration.",
+                            "[LendingMarket::open_term_rollover_window_duration_seconds] is left until expiration.",
                             "",
                             "Note: typically this flag should be used together with [Self::max_borrow_rate_bps] set to",
                             "`u32::MAX` (to denote a variable-rate reserve)."
@@ -5853,6 +6075,36 @@
                 ]
             }
         },
+        {
+            "name": "UpdateObligationConfigMode",
+            "docs": [
+                "A discriminator of a user-configurable piece of [Obligation].",
+                "",
+                "Implementation note: due to TS-side codegen quirks (and a \"convention\" currently seen e.g.",
+                "within reserve and market update operations), this is not a true Rust enum. The new value of",
+                "a config item is provided in a separate handler argument (borsh-serialized), and its expected",
+                "type is defined by each discriminator here. Additionally, each update mode acts on a specific",
+                "[ObligationConfigUpdateSubject] (e.g. the auto-rollover of fixed-term borrows is configured on",
+                "a per-borrow basis), which is also specified by separate handler arguments."
+            ],
+            "type": {
+                "kind": "enum",
+                "variants": [
+                    {
+                        "name": "FixedTermRolloverEnabled"
+                    },
+                    {
+                        "name": "FixedTermRolloverMaxBorrowRateBps"
+                    },
+                    {
+                        "name": "FixedTermRolloverMinDebtTermSeconds"
+                    },
+                    {
+                        "name": "FixedTermRolloverOpenTermAllowed"
+                    }
+                ]
+            }
+        },
         {
             "name": "BigFractionBytes",
             "type": {
@@ -7634,6 +7886,51 @@
             "code": 6153,
             "name": "WithdrawTicketProgressCallbackAccountsMissing",
             "msg": "One or more accounts required by the ticket's configured progress callback are missing"
+        },
+        {
+            "code": 6154,
+            "name": "BorrowRolloverConfigurationDisabled",
+            "msg": "Configuring auto-rollover on loans is disabled by market owner"
+        },
+        {
+            "code": 6155,
+            "name": "InvalidObligationConfigUpdateSubject",
+            "msg": "Invalid specification of the Obligation's part to be configured"
+        },
+        {
+            "code": 6156,
+            "name": "BorrowRolloverLiquidityMintMismatch",
+            "msg": "Auto-rollover must use a target reserve of the same token"
+        },
+        {
+            "code": 6157,
+            "name": "ObligationBorrowRolloverNotApplicable",
+            "msg": "The given borrow is not fixed-term and does not require rolling over"
+        },
+        {
+            "code": 6158,
+            "name": "ObligationBorrowOutsideRolloverWindow",
+            "msg": "The given borrow is outside the corresponding market-configured rollover window"
+        },
+        {
+            "code": 6159,
+            "name": "ObligationBorrowRolloverNotEnabledByOwner",
+            "msg": "Obligation's owner did not opt-in for auto-rollover of the given borrow"
+        },
+        {
+            "code": 6160,
+            "name": "ObligationBorrowRolloverTargetReserveMismatch",
+            "msg": "Obligation's owner did not allow to roll over into terms offered by the given reserve"
+        },
+        {
+            "code": 6161,
+            "name": "BorrowRolloverExecutionDisabled",
+            "msg": "Executing auto-rollover is disabled by market owner"
+        },
+        {
+            "code": 6162,
+            "name": "ObligationAccountingMismatch",
+            "msg": "Obligation internal state accounting has been unexpectedly modified"
         }
     ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamino-finance/klend-sdk",
-  "version": "7.4.0-beta.5",
+  "version": "7.4.0-beta.6",
   "description": "Typescript SDK for interacting with the Kamino Lending (klend) protocol",
   "repository": {
     "type": "git",

package/src/@codegen/klend/accounts/LendingMarket.ts

@@ -137,8 +137,8 @@ export interface LendingMarketFields {
    * Whether the owners can enable the "fixed term borrow rollover" on their obligations.
    *
    * *Note 1:* the actual execution of (different kinds of) rollovers can be disabled by zeroing
-   * [Self::fixed_rollover_window_duration_seconds] and
-   * [Self::variable_rollover_window_duration_seconds].
+   * [Self::fixed_term_rollover_window_duration_seconds] and
+   * [Self::open_term_rollover_window_duration_seconds].
    *
    * *Note 2:* when this configuration is disabled, the obligation owners can still disable their
    * rollover (i.e. set the obligation's flags to zeroes).
@@ -158,17 +158,17 @@ export interface LendingMarketFields {
    *
    * See [FixedTermBorrowRolloverConfig].
    */
-  fixedRolloverWindowDurationSeconds: BN
+  fixedTermRolloverWindowDurationSeconds: BN
   /**
    * A configurable time window (right before the end of a fixed debt term) during which an
    * auto-rollover into a *variable* (indefinite) rate/term can happen.
    *
    * When zeroed, this rollover mode is effectively disabled.
    *
-   * This will typically be shorter than [Self::fixed_rollover_window_duration_seconds], acting
-   * as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
+   * This will typically be shorter than [Self::fixed_term_rollover_window_duration_seconds],
+   * acting as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
    */
-  variableRolloverWindowDurationSeconds: BN
+  openTermRolloverWindowDurationSeconds: BN
   padding1: Array<BN>
 }
 
@@ -294,8 +294,8 @@ export interface LendingMarketJSON {
    * Whether the owners can enable the "fixed term borrow rollover" on their obligations.
    *
    * *Note 1:* the actual execution of (different kinds of) rollovers can be disabled by zeroing
-   * [Self::fixed_rollover_window_duration_seconds] and
-   * [Self::variable_rollover_window_duration_seconds].
+   * [Self::fixed_term_rollover_window_duration_seconds] and
+   * [Self::open_term_rollover_window_duration_seconds].
    *
    * *Note 2:* when this configuration is disabled, the obligation owners can still disable their
    * rollover (i.e. set the obligation's flags to zeroes).
@@ -315,17 +315,17 @@ export interface LendingMarketJSON {
    *
    * See [FixedTermBorrowRolloverConfig].
    */
-  fixedRolloverWindowDurationSeconds: string
+  fixedTermRolloverWindowDurationSeconds: string
   /**
    * A configurable time window (right before the end of a fixed debt term) during which an
    * auto-rollover into a *variable* (indefinite) rate/term can happen.
    *
    * When zeroed, this rollover mode is effectively disabled.
    *
-   * This will typically be shorter than [Self::fixed_rollover_window_duration_seconds], acting
-   * as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
+   * This will typically be shorter than [Self::fixed_term_rollover_window_duration_seconds],
+   * acting as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
    */
-  variableRolloverWindowDurationSeconds: string
+  openTermRolloverWindowDurationSeconds: string
   padding1: Array<string>
 }
 
@@ -451,8 +451,8 @@ export class LendingMarket {
    * Whether the owners can enable the "fixed term borrow rollover" on their obligations.
    *
    * *Note 1:* the actual execution of (different kinds of) rollovers can be disabled by zeroing
-   * [Self::fixed_rollover_window_duration_seconds] and
-   * [Self::variable_rollover_window_duration_seconds].
+   * [Self::fixed_term_rollover_window_duration_seconds] and
+   * [Self::open_term_rollover_window_duration_seconds].
    *
    * *Note 2:* when this configuration is disabled, the obligation owners can still disable their
    * rollover (i.e. set the obligation's flags to zeroes).
@@ -472,17 +472,17 @@ export class LendingMarket {
    *
    * See [FixedTermBorrowRolloverConfig].
    */
-  readonly fixedRolloverWindowDurationSeconds: BN
+  readonly fixedTermRolloverWindowDurationSeconds: BN
   /**
    * A configurable time window (right before the end of a fixed debt term) during which an
    * auto-rollover into a *variable* (indefinite) rate/term can happen.
    *
    * When zeroed, this rollover mode is effectively disabled.
    *
-   * This will typically be shorter than [Self::fixed_rollover_window_duration_seconds], acting
-   * as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
+   * This will typically be shorter than [Self::fixed_term_rollover_window_duration_seconds],
+   * acting as a fallback if a fixed reserve liquidity remains unavailable for considerable time.
    */
-  readonly variableRolloverWindowDurationSeconds: BN
+  readonly openTermRolloverWindowDurationSeconds: BN
   readonly padding1: Array<BN>
 
   static readonly discriminator = Buffer.from([
@@ -530,8 +530,8 @@ export class LendingMarket {
     borsh.u8("obligationBorrowRolloverConfigurationEnabled"),
     borsh.array(borsh.u8(), 5, "padding2"),
     borsh.u64("minWithdrawQueuedLiquidityValue"),
-    borsh.u64("fixedRolloverWindowDurationSeconds"),
-    borsh.u64("variableRolloverWindowDurationSeconds"),
+    borsh.u64("fixedTermRolloverWindowDurationSeconds"),
+    borsh.u64("openTermRolloverWindowDurationSeconds"),
     borsh.array(borsh.u64(), 161, "padding1"),
   ])
 
@@ -591,10 +591,10 @@ export class LendingMarket {
     this.padding2 = fields.padding2
     this.minWithdrawQueuedLiquidityValue =
       fields.minWithdrawQueuedLiquidityValue
-    this.fixedRolloverWindowDurationSeconds =
-      fields.fixedRolloverWindowDurationSeconds
-    this.variableRolloverWindowDurationSeconds =
-      fields.variableRolloverWindowDurationSeconds
+    this.fixedTermRolloverWindowDurationSeconds =
+      fields.fixedTermRolloverWindowDurationSeconds
+    this.openTermRolloverWindowDurationSeconds =
+      fields.openTermRolloverWindowDurationSeconds
     this.padding1 = fields.padding1
   }
 
@@ -695,10 +695,10 @@ export class LendingMarket {
         dec.obligationBorrowRolloverConfigurationEnabled,
       padding2: dec.padding2,
       minWithdrawQueuedLiquidityValue: dec.minWithdrawQueuedLiquidityValue,
-      fixedRolloverWindowDurationSeconds:
-        dec.fixedRolloverWindowDurationSeconds,
-      variableRolloverWindowDurationSeconds:
-        dec.variableRolloverWindowDurationSeconds,
+      fixedTermRolloverWindowDurationSeconds:
+        dec.fixedTermRolloverWindowDurationSeconds,
+      openTermRolloverWindowDurationSeconds:
+        dec.openTermRolloverWindowDurationSeconds,
       padding1: dec.padding1,
     })
   }
@@ -756,10 +756,10 @@ export class LendingMarket {
       padding2: this.padding2,
       minWithdrawQueuedLiquidityValue:
         this.minWithdrawQueuedLiquidityValue.toString(),
-      fixedRolloverWindowDurationSeconds:
-        this.fixedRolloverWindowDurationSeconds.toString(),
-      variableRolloverWindowDurationSeconds:
-        this.variableRolloverWindowDurationSeconds.toString(),
+      fixedTermRolloverWindowDurationSeconds:
+        this.fixedTermRolloverWindowDurationSeconds.toString(),
+      openTermRolloverWindowDurationSeconds:
+        this.openTermRolloverWindowDurationSeconds.toString(),
       padding1: this.padding1.map((item) => item.toString()),
     }
   }
@@ -825,11 +825,11 @@ export class LendingMarket {
       minWithdrawQueuedLiquidityValue: new BN(
         obj.minWithdrawQueuedLiquidityValue
       ),
-      fixedRolloverWindowDurationSeconds: new BN(
-        obj.fixedRolloverWindowDurationSeconds
+      fixedTermRolloverWindowDurationSeconds: new BN(
+        obj.fixedTermRolloverWindowDurationSeconds
       ),
-      variableRolloverWindowDurationSeconds: new BN(
-        obj.variableRolloverWindowDurationSeconds
+      openTermRolloverWindowDurationSeconds: new BN(
+        obj.openTermRolloverWindowDurationSeconds
       ),
       padding1: obj.padding1.map((item) => new BN(item)),
     })