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

package/src/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"
     }
   ]
 }