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

package/src/idl/klend.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.12.6",
+  "version": "1.13.0",
   "name": "kamino_lending",
   "instructions": [
     {
@@ -2980,6 +2980,213 @@
         }
       ]
     },
+    {
+      "name": "setBorrowOrder",
+      "accounts": [
+        {
+          "name": "owner",
+          "isMut": false,
+          "isSigner": true,
+          "docs": [
+            "The [Self::obligation]'s owner."
+          ]
+        },
+        {
+          "name": "obligation",
+          "isMut": true,
+          "isSigner": false,
+          "docs": [
+            "The obligation to set the [BorrowOrder] on."
+          ]
+        },
+        {
+          "name": "lendingMarket",
+          "isMut": false,
+          "isSigner": false,
+          "docs": [
+            "The [Self::obligation]'s market - needed only to validate the borrow orders' feature flag."
+          ]
+        },
+        {
+          "name": "filledDebtDestination",
+          "isMut": false,
+          "isSigner": false,
+          "docs": [
+            "The [BorrowOrder::filled_debt_destination] to set on order creation. Not editable on order",
+            "updates.",
+            "Ignored when cancelling the order."
+          ]
+        },
+        {
+          "name": "debtLiquidityMint",
+          "isMut": false,
+          "isSigner": false,
+          "docs": [
+            "The [BorrowOrder::debt_liquidity_mint] to set on order creation. Not editable on order",
+            "updates.",
+            "Ignored when cancelling the order."
+          ]
+        },
+        {
+          "name": "eventAuthority",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "program",
+          "isMut": false,
+          "isSigner": false
+        }
+      ],
+      "args": [
+        {
+          "name": "orderConfig",
+          "type": {
+            "defined": "BorrowOrderConfigArgs"
+          }
+        },
+        {
+          "name": "minExpectedCurrentRemainingDebtAmount",
+          "type": "u64"
+        }
+      ]
+    },
+    {
+      "name": "fillBorrowOrder",
+      "accounts": [
+        {
+          "name": "borrowAccounts",
+          "accounts": [
+            {
+              "name": "payer",
+              "isMut": false,
+              "isSigner": true
+            },
+            {
+              "name": "obligation",
+              "isMut": true,
+              "isSigner": false,
+              "docs": [
+                "The obligation with a [BorrowOrder]."
+              ]
+            },
+            {
+              "name": "lendingMarket",
+              "isMut": false,
+              "isSigner": false,
+              "docs": [
+                "The [Self::obligation]'s market - needed for borrowing-related 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": "borrowReserve",
+              "isMut": true,
+              "isSigner": false,
+              "docs": [
+                "The reserve to borrow from.",
+                "",
+                "Its mint must match the asset requested by the [BorrowOrder::debt_liquidity_mint]."
+              ]
+            },
+            {
+              "name": "borrowReserveLiquidityMint",
+              "isMut": false,
+              "isSigner": false,
+              "docs": [
+                "The mint of [Self::borrow_reserve] - needed to execute the transfer."
+              ]
+            },
+            {
+              "name": "reserveSourceLiquidity",
+              "isMut": true,
+              "isSigner": false,
+              "docs": [
+                "The vault of [Self::borrow_reserve], from which the funds are transferred."
+              ]
+            },
+            {
+              "name": "borrowReserveLiquidityFeeReceiver",
+              "isMut": true,
+              "isSigner": false,
+              "docs": [
+                "The fee vault of [Self::borrow_reserve], to which the fees are transferred."
+              ]
+            },
+            {
+              "name": "userDestinationLiquidity",
+              "isMut": true,
+              "isSigner": false,
+              "docs": [
+                "The destination token account that should receive the newly borrowed funds.",
+                "",
+                "It must match [BorrowOrder::filled_debt_destination], owner and mint.",
+                "",
+                "**Warning:** An altered destination account will prevent an order from being filled."
+              ]
+            },
+            {
+              "name": "referrerTokenState",
+              "isMut": true,
+              "isSigner": false,
+              "isOptional": true,
+              "docs": [
+                "The referrer's account, for accumulating fees - needed if the [Obligation::has_referrer]."
+              ]
+            },
+            {
+              "name": "tokenProgram",
+              "isMut": false,
+              "isSigner": false,
+              "docs": [
+                "The token program of [Self::borrow_reserve] - needed to execute the transfer."
+              ]
+            }
+          ]
+        },
+        {
+          "name": "farmsAccounts",
+          "accounts": [
+            {
+              "name": "obligationFarmUserState",
+              "isMut": true,
+              "isSigner": false,
+              "isOptional": true
+            },
+            {
+              "name": "reserveFarmState",
+              "isMut": true,
+              "isSigner": false,
+              "isOptional": true
+            }
+          ]
+        },
+        {
+          "name": "farmsProgram",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "eventAuthority",
+          "isMut": false,
+          "isSigner": false
+        },
+        {
+          "name": "program",
+          "isMut": false,
+          "isSigner": false
+        }
+      ],
+      "args": []
+    },
     {
       "name": "initGlobalConfig",
       "accounts": [
@@ -3085,12 +3292,6 @@
             "defined": "ReserveFarmKind"
           }
         },
-        {
-          "name": "assetTier",
-          "type": {
-            "defined": "AssetTier"
-          }
-        },
         {
           "name": "feeCalculation",
           "type": {
@@ -3520,13 +3721,35 @@
             "type": "u8"
           },
           {
-            "name": "padding2",
-            "type": {
-              "array": [
-                "u8",
-                4
-              ]
-            }
+            "name": "matureReserveDebtLiquidationEnabled",
+            "docs": [
+              "Whether the debts that reached their reserve's [ReserveConfig::debt_maturity_timestamp] can",
+              "be liquidated."
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "obligationBorrowDebtTermLiquidationEnabled",
+            "docs": [
+              "Whether the [Obligation::borrows] that reached their [ReserveConfig::debt_term_seconds] can",
+              "be liquidated."
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "borrowOrderCreationEnabled",
+            "docs": [
+              "Whether new borrow orders can be created.",
+              "Note: updating or cancelling existing orders is *not* affected by this flag."
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "borrowOrderExecutionEnabled",
+            "docs": [
+              "Whether the existing borrow orders can be filled."
+            ],
+            "type": "u8"
           },
           {
             "name": "proposerAuthority",
@@ -3656,26 +3879,14 @@
             "type": "u128"
           },
           {
-            "name": "depositsAssetTiers",
+            "name": "paddingDeprecatedAssetTiers",
             "docs": [
               "The asset tier of the deposits"
             ],
             "type": {
               "array": [
                 "u8",
-                8
-              ]
-            }
-          },
-          {
-            "name": "borrowsAssetTiers",
-            "docs": [
-              "The asset tier of the borrows"
-            ],
-            "type": {
-              "array": [
-                "u8",
-                5
+                13
               ]
             }
           },
@@ -3758,9 +3969,9 @@
             "type": "u64"
           },
           {
-            "name": "orders",
+            "name": "obligationOrders",
             "docs": [
-              "Owner-defined, liquidator-executed orders applicable to this obligation.",
+              "Owner-defined, permissionlessly-executed repay orders.",
               "Typical use-cases would be a stop-loss and a take-profit (possibly co-existing)."
             ],
             "type": {
@@ -3772,12 +3983,22 @@
               ]
             }
           },
+          {
+            "name": "borrowOrder",
+            "docs": [
+              "Owner-defined, permissionlessly-executed borrow order applicable to this obligation.",
+              "Non-zeroed only on a newly-initialized fixed-rate, fixed-term obligation."
+            ],
+            "type": {
+              "defined": "BorrowOrder"
+            }
+          },
           {
             "name": "padding3",
             "type": {
               "array": [
                 "u64",
-                93
+                73
               ]
             }
           }
@@ -4014,7 +4235,7 @@
             "type": {
               "array": [
                 "u64",
-                116
+                114
               ]
             }
           },
@@ -4049,6 +4270,33 @@
     }
   ],
   "types": [
+    {
+      "name": "BorrowOrderConfigArgs",
+      "docs": [
+        "A subset of [BorrowOrderConfig] excluding the accounts passed via [SetBorrowOrder]."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "remainingDebtAmount",
+            "type": "u64"
+          },
+          {
+            "name": "maxBorrowRateBps",
+            "type": "u32"
+          },
+          {
+            "name": "minDebtTermSeconds",
+            "type": "u64"
+          },
+          {
+            "name": "fillableUntilTimestamp",
+            "type": "u64"
+          }
+        ]
+      }
+    },
     {
       "name": "UpdateConfigMode",
       "type": {
@@ -4154,7 +4402,7 @@
             "name": "UpdateBorrowFactor"
           },
           {
-            "name": "UpdateAssetTier"
+            "name": "DeprecatedUpdateAssetTier"
           },
           {
             "name": "UpdateElevationGroup"
@@ -4212,6 +4460,12 @@
           },
           {
             "name": "UpdateBlockCTokenUsage"
+          },
+          {
+            "name": "UpdateDebtMaturityTimestamp"
+          },
+          {
+            "name": "UpdateDebtTermSeconds"
           }
         ]
       }
@@ -4375,6 +4629,18 @@
           },
           {
             "name": "UpdatePriceTriggeredLiquidationDisabled"
+          },
+          {
+            "name": "UpdateMatureReserveDebtLiquidationEnabled"
+          },
+          {
+            "name": "UpdateObligationBorrowDebtTermLiquidationEnabled"
+          },
+          {
+            "name": "UpdateBorrowOrderCreationEnabled"
+          },
+          {
+            "name": "UpdateBorrowOrderExecutionEnabled"
           }
         ]
       }
@@ -4486,6 +4752,120 @@
         ]
       }
     },
+    {
+      "name": "BorrowOrder",
+      "docs": [
+        "A borrow order.",
+        "",
+        "When the [Obligation::borrow_order] is populated (i.e. non-zeroed) on an Obligation, then the",
+        "permissionless \"fill\" operations may borrow liquidity to the owner according to this",
+        "specification."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "debtLiquidityMint",
+            "docs": [
+              "The asset to be borrowed.",
+              "The reserves used for [Obligation::borrows] *must* all provide exactly this asset."
+            ],
+            "type": "publicKey"
+          },
+          {
+            "name": "remainingDebtAmount",
+            "docs": [
+              "The amount of debt that still needs to be filled, in lamports."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "filledDebtDestination",
+            "docs": [
+              "The token account owned by the [Obligation::owner] and holding [Self::debt_liquidity_mint],",
+              "where the filled funds should be transferred to."
+            ],
+            "type": "publicKey"
+          },
+          {
+            "name": "minDebtTermSeconds",
+            "docs": [
+              "The minimum allowed debt term that the obligation owner agrees to.",
+              "The reserves used to fill this order *cannot* define their debt term *lower* than this.",
+              "",
+              "If zeroed, then only indefinite-term reserves may be used."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "fillableUntilTimestamp",
+            "docs": [
+              "The time until which the borrow order can still be filled."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "placedAtTimestamp",
+            "docs": [
+              "The time at which this order was placed.",
+              "Currently, this is only a piece of metadata."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "lastUpdatedAtTimestamp",
+            "docs": [
+              "The time at which this order was most-recently updated (including: created).",
+              "Currently, this is only a piece of metadata."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "requestedDebtAmount",
+            "docs": [
+              "The amount of debt that was originally requested when this order was most-recently updated.",
+              "In other words: this field holds a value of [Self::remaining_debt_amount] captured at",
+              "[Self::last_updated_at_timestamp].",
+              "Currently, this is only a piece of metadata."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "maxBorrowRateBps",
+            "docs": [
+              "The maximum borrow rate that the obligation owner agrees to.",
+              "The reserves used for [Obligation::borrows] *cannot* define their maximum borrow rate",
+              "*higher* than this."
+            ],
+            "type": "u32"
+          },
+          {
+            "name": "padding1",
+            "docs": [
+              "Alignment padding."
+            ],
+            "type": {
+              "array": [
+                "u8",
+                4
+              ]
+            }
+          },
+          {
+            "name": "endPadding",
+            "docs": [
+              "End padding."
+            ],
+            "type": {
+              "array": [
+                "u64",
+                5
+              ]
+            }
+          }
+        ]
+      }
+    },
     {
       "name": "InitObligationArgs",
       "type": {
@@ -4578,7 +4958,17 @@
             }
           },
           {
-            "name": "padding",
+            "name": "firstBorrowedAtTimestamp",
+            "docs": [
+              "The timestamp at which this debt was taken.",
+              "More specifically: when the *first* borrow operation from this reserve happened.",
+              "This means that:",
+              "- adding debt of the same reserve does *not* change this timestamp,",
+              "- repaying the entire debt of this reserve *does* reset this timestamp.",
+              "",
+              "Note: this field is *not* only metadata: it is used in the logic, e.g. for enforcing the",
+              "fixed-term borrows (i.e. those induced by [ReserveConfig::debt_term_seconds])."
+            ],
             "type": "u64"
           },
           {
@@ -4625,7 +5015,7 @@
       "name": "ObligationOrder",
       "docs": [
         "A single obligation order.",
-        "See [Obligation::orders]."
+        "See [Obligation::obligation_orders]."
       ],
       "type": {
         "kind": "struct",
@@ -4722,7 +5112,7 @@
           {
             "name": "padding1",
             "docs": [
-              "Internal padding.",
+              "Alignment padding.",
               "The fields above take up 2+2+1+1 bytes = 48 bits, which means we need 80 bits = 10 bytes to",
               "align with `u128`s."
             ],
@@ -4749,23 +5139,6 @@
         ]
       }
     },
-    {
-      "name": "AssetTier",
-      "type": {
-        "kind": "enum",
-        "variants": [
-          {
-            "name": "Regular"
-          },
-          {
-            "name": "IsolatedCollateral"
-          },
-          {
-            "name": "IsolatedDebt"
-          }
-        ]
-      }
-    },
     {
       "name": "BigFractionBytes",
       "type": {
@@ -4875,7 +5248,7 @@
             "type": "u8"
           },
           {
-            "name": "assetTier",
+            "name": "paddingDeprecatedAssetTier",
             "docs": [
               "Asset tier -> 0 - regular (collateral & debt), 1 - isolated collateral, 2 - isolated debt"
             ],
@@ -5129,6 +5502,29 @@
               "Only relevant when `autodeleverage_enabled == 1`, and must not be 0 in such case."
             ],
             "type": "u64"
+          },
+          {
+            "name": "debtMaturityTimestamp",
+            "docs": [
+              "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."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "debtTermSeconds",
+            "docs": [
+              "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]."
+            ],
+            "type": "u64"
           }
         ]
       }
@@ -5614,6 +6010,82 @@
       }
     }
   ],
+  "events": [
+    {
+      "name": "BorrowOrderCancelEvent",
+      "fields": [
+        {
+          "name": "before",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        }
+      ]
+    },
+    {
+      "name": "BorrowOrderFullFillEvent",
+      "fields": [
+        {
+          "name": "before",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        }
+      ]
+    },
+    {
+      "name": "BorrowOrderPartialFillEvent",
+      "fields": [
+        {
+          "name": "before",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        },
+        {
+          "name": "after",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        }
+      ]
+    },
+    {
+      "name": "BorrowOrderPlaceEvent",
+      "fields": [
+        {
+          "name": "after",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        }
+      ]
+    },
+    {
+      "name": "BorrowOrderUpdateEvent",
+      "fields": [
+        {
+          "name": "before",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        },
+        {
+          "name": "after",
+          "type": {
+            "defined": "BorrowOrder"
+          },
+          "index": false
+        }
+      ]
+    }
+  ],
   "errors": [
     {
       "code": 6000,
@@ -6279,6 +6751,61 @@
       "code": 6132,
       "name": "CTokenUsageBlocked",
       "msg": "CToken minting/redeeming is blocked for this reserve"
+    },
+    {
+      "code": 6133,
+      "name": "CannotUseSameReserve",
+      "msg": "Cannot call ix with same reserve"
+    },
+    {
+      "code": 6134,
+      "name": "TransactionIncludesRestrictedPrograms",
+      "msg": "Transaction includes restricted programs"
+    },
+    {
+      "code": 6135,
+      "name": "BorrowOrderDebtLiquidityMintMismatch",
+      "msg": "There is no borrow order requesting debt in the given asset"
+    },
+    {
+      "code": 6136,
+      "name": "BorrowOrderMaxBorrowRateExceeded",
+      "msg": "Reserve used for fill exceeds the maximum borrow rate specified by the order"
+    },
+    {
+      "code": 6137,
+      "name": "BorrowOrderMinDebtTermInsufficient",
+      "msg": "Reserve used for fill defines a debt term shorter than specified by the order"
+    },
+    {
+      "code": 6138,
+      "name": "BorrowOrderFillTimeLimitExceeded",
+      "msg": "Borrow order can no longer be filled"
+    },
+    {
+      "code": 6139,
+      "name": "ReserveDebtMaturityReached",
+      "msg": "Cannot borrow from a reserve that reached its debt maturity timestamp"
+    },
+    {
+      "code": 6140,
+      "name": "NonUpdatableOrderConfiguration",
+      "msg": "Some piece of the order's configuration cannot be updated (the order should be cancelled and placed again)"
+    },
+    {
+      "code": 6141,
+      "name": "BorrowOrderExecutionDisabled",
+      "msg": "Execution of borrow orders is disabled"
+    },
+    {
+      "code": 6142,
+      "name": "DebtReachedReserveDebtTerm",
+      "msg": "Cannot increase the debt that has reached its end of term configured by the reserve"
+    },
+    {
+      "code": 6143,
+      "name": "ExpectationNotMet",
+      "msg": "The on-chain state does not meet expectation specified by the caller, so the operation must be aborted (to avoid race conditions)"
     }
   ]
 }