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

package/dist/idl/klend.json

@@ -1,5 +1,5 @@
 {
-    "version": "1.13.0",
+    "version": "1.13.1",
     "name": "kamino_lending",
     "instructions": [
         {
@@ -3187,6 +3187,410 @@
             ],
             "args": []
         },
+        {
+            "name": "enqueueToWithdraw",
+            "accounts": [
+                {
+                    "name": "owner",
+                    "isMut": true,
+                    "isSigner": true,
+                    "docs": [
+                        "The depositor holding ctokens."
+                    ]
+                },
+                {
+                    "name": "lendingMarket",
+                    "isMut": false,
+                    "isSigner": false
+                },
+                {
+                    "name": "lendingMarketAuthority",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The market's authority, needed to initialize the [Self::owner_queued_collateral_vault]."
+                    ]
+                },
+                {
+                    "name": "reserve",
+                    "isMut": true,
+                    "isSigner": false
+                },
+                {
+                    "name": "userSourceCollateralTa",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The source of collateral to be enqueued."
+                    ]
+                },
+                {
+                    "name": "userDestinationLiquidityTa",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The account to which the liquidity should be finally transferred later (to be recorded in",
+                        "the ticket)."
+                    ]
+                },
+                {
+                    "name": "reserveLiquidityMint",
+                    "isMut": false,
+                    "isSigner": false
+                },
+                {
+                    "name": "reserveCollateralMint",
+                    "isMut": false,
+                    "isSigner": false
+                },
+                {
+                    "name": "collateralTokenProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The collateral's program - needed for invoking the transfer to the vault *and* (implicitly)",
+                        "for handling the `init_if_needed`."
+                    ]
+                },
+                {
+                    "name": "withdrawTicket",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The new account to be initialized with the issued ticket's data."
+                    ]
+                },
+                {
+                    "name": "ownerQueuedCollateralVault",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The per-owner \"this reserve's queued collateral\" vault (in which the collateral will be",
+                        "locked)."
+                    ]
+                },
+                {
+                    "name": "systemProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The System program - needed only for `init` / `init_if_needed` of the accounts above."
+                    ]
+                },
+                {
+                    "name": "progressCallbackCustomAccount0",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The first one out of maximum 2 custom accounts that may be required if the optional \"ticket",
+                        "progress callback\" is configured for this ticket.",
+                        "",
+                        "The expected custom accounts are validated based on the `progress_callback_type` instruction",
+                        "argument. The currently supported ones are:",
+                        "- for [ProgressCallbackType::None] no custom accounts are expected (this is the default",
+                        "behavior, when the instruction data is zeroed or absent).",
+                        "- for [ProgressCallbackType::KlendQueueAccountingHandlerOnKvault], only the `_0` custom",
+                        "account is required:",
+                        "- the `_0` custom account must represent the `VaultState` which disinvests from the",
+                        "reserve (readonly; needed to be later passed as an input to the Kvault's handler);",
+                        "- the `_1` custom account is ignored;",
+                        "- the `owner` account (i.e. the signer) must be a Kvault-owned PDA base authority",
+                        "associated with the vault indicated by `_0` (needed to prove that Kvault is CPI'ing this",
+                        "handler)."
+                    ]
+                },
+                {
+                    "name": "progressCallbackCustomAccount1",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The second possible account (see the `progress_callback_custom_account_0` above)."
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "collateralAmount",
+                    "type": "u64"
+                },
+                {
+                    "name": "progressCallbackType",
+                    "type": {
+                        "defined": "ProgressCallbackType"
+                    }
+                }
+            ]
+        },
+        {
+            "name": "withdrawQueuedLiquidity",
+            "accounts": [
+                {
+                    "name": "payer",
+                    "isMut": true,
+                    "isSigner": true,
+                    "docs": [
+                        "The executor of the permissionless tx (not necessarily the ticket owner)."
+                    ]
+                },
+                {
+                    "name": "lendingMarket",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The lending market."
+                    ]
+                },
+                {
+                    "name": "lendingMarketAuthority",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The market's authority, needed for burning the collateral (from",
+                        "[Self::owner_queued_collateral_vault]) and transferring the liquidity (from",
+                        "[Self::reserve_liquidity_supply])."
+                    ]
+                },
+                {
+                    "name": "reserve",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The reserve."
+                    ]
+                },
+                {
+                    "name": "reserveLiquidityMint",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The liquidity mint, needed to invoke the transfer."
+                    ]
+                },
+                {
+                    "name": "reserveCollateralMint",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The collateral mint, needed to burn (`mut`!) the queued collateral."
+                    ]
+                },
+                {
+                    "name": "reserveLiquiditySupply",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The liquidity supply vault (to withdraw the liquidity from)."
+                    ]
+                },
+                {
+                    "name": "ownerQueuedCollateralVault",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The per-owner \"this reserve's queued collateral\" vault (from which the collateral will be",
+                        "burnt)."
+                    ]
+                },
+                {
+                    "name": "userDestinationLiquidity",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The token account to which the liquidity should be transferred (the one recorded in the",
+                        "ticket)."
+                    ]
+                },
+                {
+                    "name": "collateralTokenProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The program of [Self::reserve_collateral_mint], needed for transfer."
+                    ]
+                },
+                {
+                    "name": "liquidityTokenProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The program of [Self::reserve_liquidity_mint], needed for transfer."
+                    ]
+                },
+                {
+                    "name": "withdrawTicket",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The ticket's data itself.",
+                        "",
+                        "Note: in case of complete withdrawal, this account will be closed. In case of partial",
+                        "withdrawal, its [WithdrawTicket::queued_collateral_amount] will simply be reduced, and the",
+                        "ticket will maintain its position in the queue."
+                    ]
+                },
+                {
+                    "name": "withdrawTicketOwner",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The owner of the [Self::withdraw_ticket]; needed only to return the rent of the",
+                        "[WithdrawTicket] account (if it is getting fully-consumed and closed here)."
+                    ]
+                },
+                {
+                    "name": "associatedTokenProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The ATA program - needed for potential destination ATA creation."
+                    ]
+                },
+                {
+                    "name": "systemProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The System program - needed for potential destination ATA creation."
+                    ]
+                },
+                {
+                    "name": "progressCallbackProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The progress callback program (if configured by the withdraw ticket)."
+                    ]
+                },
+                {
+                    "name": "progressCallbackCustomAccount0",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The first one out of maximum 2 custom accounts that may be required if the withdraw ticket",
+                        "defines a callback.",
+                        "Please note that the constraints defined here do not mention `mut`, but a specific",
+                        "[WithdrawTicket::progress_callback_type] may require it."
+                    ]
+                },
+                {
+                    "name": "progressCallbackCustomAccount1",
+                    "isMut": false,
+                    "isSigner": false,
+                    "isOptional": true,
+                    "docs": [
+                        "The second possibly-required account (see the `progress_callback_custom_account_0` above)."
+                    ]
+                }
+            ],
+            "args": [],
+            "returns": "bool"
+        },
+        {
+            "name": "recoverInvalidTicketCollateral",
+            "accounts": [
+                {
+                    "name": "payer",
+                    "isMut": false,
+                    "isSigner": true,
+                    "docs": [
+                        "The transaction executor.",
+                        "",
+                        "This instruction is, in principle, permissionless. However, only the ticket owner can use",
+                        "arbitrary token account as destination for recovered collateral. Other signers can only",
+                        "transfer the collateral to the ticket owner's ATA (see [Self::user_source_collateral])."
+                    ]
+                },
+                {
+                    "name": "lendingMarket",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The lending market."
+                    ]
+                },
+                {
+                    "name": "lendingMarketAuthority",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The market's authority, needed for transferring the collateral (from",
+                        "[Self::owner_queued_collateral_vault])."
+                    ]
+                },
+                {
+                    "name": "reserve",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The reserve, needed only to validate the other accounts."
+                    ]
+                },
+                {
+                    "name": "reserveCollateralMint",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The collateral mint, needed to invoke the transfer."
+                    ]
+                },
+                {
+                    "name": "ownerQueuedCollateralVault",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The per-owner \"this reserve's queued collateral\" vault (from which the collateral will be",
+                        "recovered)."
+                    ]
+                },
+                {
+                    "name": "userSourceCollateral",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The ticket's owner token account to which the ticket-locked collateral should be returned.",
+                        "",
+                        "Only the ticket's owner can indicate an arbitrary token account here. Permissionless",
+                        "executors must indicate the ticket's owner ATA."
+                    ]
+                },
+                {
+                    "name": "collateralTokenProgram",
+                    "isMut": false,
+                    "isSigner": false,
+                    "docs": [
+                        "The program of [Self::reserve_collateral_mint], needed for transfer."
+                    ]
+                },
+                {
+                    "name": "withdrawTicket",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The ticket's account, necessarily marked as [WithdrawTicket::invalid] first (by the",
+                        "`handler_withdraw_queued_liquidity`)."
+                    ]
+                },
+                {
+                    "name": "withdrawTicketOwner",
+                    "isMut": true,
+                    "isSigner": false,
+                    "docs": [
+                        "The owner of the [Self::withdraw_ticket]; needed only to return the rent of the",
+                        "[WithdrawTicket] account."
+                    ]
+                }
+            ],
+            "args": [
+                {
+                    "name": "ticketSequenceNumber",
+                    "type": "u64"
+                }
+            ]
+        },
         {
             "name": "initGlobalConfig",
             "accounts": [
@@ -3565,7 +3969,8 @@
                     {
                         "name": "minFullLiquidationValueThreshold",
                         "docs": [
-                            "Minimum liquidation value threshold triggering full liquidation for an obligation"
+                            "Minimum liquidation value threshold triggering full liquidation for an obligation, in full",
+                            "units of the quote currency (e.g. `2` means \"$2\", not \"2 lamports of USDC\")."
                         ],
                         "type": "u64"
                     },
@@ -3709,61 +4114,133 @@
                         "type": "u8"
                     },
                     {
-                        "name": "priceTriggeredLiquidationDisabled",
+                        "name": "priceTriggeredLiquidationDisabled",
+                        "docs": [
+                            "Whether the liquidation operations that are triggered by price changes should be disabled.",
+                            "This includes regular liquidation (i.e. LTV exceeding the unhealthy threshold) and some",
+                            "obligation orders' execution.",
+                            "",
+                            "*Caution:* this flag is *disabling* the liquidations when `1` - contrary to all the other",
+                            "liquidation-driving flags (see e.g. [Self::autodeleverage_enabled])."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "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",
+                        "docs": [
+                            "Authority that can propose creating of new reserves but cannot enable them."
+                        ],
+                        "type": "publicKey"
+                    },
+                    {
+                        "name": "withdrawTicketIssuanceEnabled",
                         "docs": [
-                            "Whether the liquidation operations that are triggered by price changes should be disabled.",
-                            "This includes regular liquidation (i.e. LTV exceeding the unhealthy threshold) and some",
-                            "obligation orders' execution.",
-                            "",
-                            "*Caution:* this flag is *disabling* the liquidations when `1` - contrary to all the other",
-                            "liquidation-driving flags (see e.g. [Self::autodeleverage_enabled])."
+                            "Whether any new withdraw tickets can be issued (i.e. whether new requests can enter the",
+                            "withdraw queue)."
                         ],
                         "type": "u8"
                     },
                     {
-                        "name": "matureReserveDebtLiquidationEnabled",
+                        "name": "withdrawTicketRedemptionEnabled",
                         "docs": [
-                            "Whether the debts that reached their reserve's [ReserveConfig::debt_maturity_timestamp] can",
-                            "be liquidated."
+                            "Whether the existing withdraw tickets can be redeemed (i.e. whether the tickets can be used",
+                            "to transfer accumulated pending liquidity to destination accounts)."
                         ],
                         "type": "u8"
                     },
                     {
-                        "name": "obligationBorrowDebtTermLiquidationEnabled",
+                        "name": "obligationBorrowRolloverConfigurationEnabled",
                         "docs": [
-                            "Whether the [Obligation::borrows] that reached their [ReserveConfig::debt_term_seconds] can",
-                            "be liquidated."
+                            "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].",
+                            "",
+                            "*Note 2:* when this configuration is disabled, the obligation owners can still disable their",
+                            "rollover (i.e. set the obligation's flags to zeroes)."
                         ],
                         "type": "u8"
                     },
                     {
-                        "name": "borrowOrderCreationEnabled",
+                        "name": "padding2",
+                        "type": {
+                            "array": [
+                                "u8",
+                                5
+                            ]
+                        }
+                    },
+                    {
+                        "name": "minWithdrawQueuedLiquidityValue",
                         "docs": [
-                            "Whether new borrow orders can be created.",
-                            "Note: updating or cancelling existing orders is *not* affected by this flag."
+                            "Minimum value that can be withdrawn in a single `withdraw_queued_liquidity()` call, in full",
+                            "units of the quote currency (e.g. `2` means \"$2\", not \"2 lamports of USDC\")."
                         ],
-                        "type": "u8"
+                        "type": "u64"
                     },
                     {
-                        "name": "borrowOrderExecutionEnabled",
+                        "name": "fixedRolloverWindowDurationSeconds",
                         "docs": [
-                            "Whether the existing borrow orders can be filled."
+                            "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.",
+                            "",
+                            "When zeroed, this rollover mode is effectively disabled.",
+                            "",
+                            "See [FixedTermBorrowRolloverConfig]."
                         ],
-                        "type": "u8"
+                        "type": "u64"
                     },
                     {
-                        "name": "proposerAuthority",
+                        "name": "variableRolloverWindowDurationSeconds",
                         "docs": [
-                            "Authority that can propose creating of new reserves but cannot enable them."
+                            "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."
                         ],
-                        "type": "publicKey"
+                        "type": "u64"
                     },
                     {
                         "name": "padding1",
                         "type": {
                             "array": [
                                 "u64",
-                                165
+                                161
                             ]
                         }
                     }
@@ -4256,12 +4733,148 @@
                             ]
                         }
                     },
+                    {
+                        "name": "withdrawQueue",
+                        "docs": [
+                            "The tracker of ticket-based withdrawals."
+                        ],
+                        "type": {
+                            "defined": "WithdrawQueue"
+                        }
+                    },
                     {
                         "name": "padding",
                         "type": {
                             "array": [
                                 "u64",
-                                207
+                                204
+                            ]
+                        }
+                    }
+                ]
+            }
+        },
+        {
+            "name": "WithdrawTicket",
+            "docs": [
+                "A finite-lifecycle account representing a specific depositor's place in the withdraw queue of",
+                "a specific reserve.",
+                "",
+                "The lifecycle:",
+                "1. The depositor holding ctokens wants to withdraw funds from the reserve, and finds out that",
+                "the required amount is not available (due to high utilization).",
+                "2. The depositor calls the `enqueue_to_withdraw` handler.",
+                "3. The handler transfers the depositor's ctokens to the reserve's internal \"pending\" vault.",
+                "4. The handler initializes a new [WithdrawTicket] account, with the next available sequence",
+                "number.",
+                "5. The depositor waits until his ticket is the next expected one for actual withdraw, and until",
+                "the reserve has enough liquidity.",
+                "6. Anyone (the depositor or a bot) calls the permissionless `withdraw_queued_liquidity`",
+                "handler. If the ticket became invalid (e.g. destination account no longer exists), then the",
+                "depositor can call the `recover_invalid_ticket_collateral` handler instead.",
+                "7. The handler transfers the liquidity amount according to the current exchange rate.",
+                "8. The handler closes the ticket account."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "sequenceNumber",
+                        "docs": [
+                            "This ticket's place in the queue; the same as used for PDA derivation."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "owner",
+                        "docs": [
+                            "The funds' owner (the user who called the `enqueue_to_withdraw` handler)."
+                        ],
+                        "type": "publicKey"
+                    },
+                    {
+                        "name": "reserve",
+                        "docs": [
+                            "The reserve to withdraw from."
+                        ],
+                        "type": "publicKey"
+                    },
+                    {
+                        "name": "userDestinationLiquidityTa",
+                        "docs": [
+                            "The token account to which the finally-available liquidity should be transferred (by the",
+                            "`withdraw_queued_liquidity` handler)."
+                        ],
+                        "type": "publicKey"
+                    },
+                    {
+                        "name": "queuedCollateralAmount",
+                        "docs": [
+                            "The amount of collateral still waiting to be withdrawn using this ticket."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "createdAtTimestamp",
+                        "docs": [
+                            "The timestamp at which the queue was entered.",
+                            "",
+                            "This is currently only a piece of metadata, not used by the logic."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "invalid",
+                        "docs": [
+                            "Whether the ticket has been found to be invalid (e.g. the [Self::user_destination_liquidity]",
+                            "has been repurposed) by the `withdraw_queued_liquidity` handler.",
+                            "To be specific: valid = `0`, invalid = `1`.",
+                            "",
+                            "An invalid ticket cannot be made valid again, and can only be passed to the",
+                            "`recover_invalid_ticket_collateral` handler."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "progressCallbackType",
+                        "docs": [
+                            "One of the valid [ProgressCallbackType] representations."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "alignmentPadding",
+                        "docs": [
+                            "Inner padding, for alignment."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                6
+                            ]
+                        }
+                    },
+                    {
+                        "name": "progressCallbackCustomAccounts",
+                        "docs": [
+                            "The (optional) accounts to be used by [Self::progress_callback_type]s."
+                        ],
+                        "type": {
+                            "array": [
+                                "publicKey",
+                                2
+                            ]
+                        }
+                    },
+                    {
+                        "name": "endPadding",
+                        "docs": [
+                            "Trailing padding, for future developments."
+                        ],
+                        "type": {
+                            "array": [
+                                "u64",
+                                40
                             ]
                         }
                     }
@@ -4375,7 +4988,7 @@
                         "name": "UpdateBorrowRateCurve"
                     },
                     {
-                        "name": "UpdateEntireReserveConfig"
+                        "name": "DeprecatedUpdateEntireReserveConfig"
                     },
                     {
                         "name": "UpdateDebtWithdrawalCap"
@@ -4641,6 +5254,24 @@
                     },
                     {
                         "name": "UpdateBorrowOrderExecutionEnabled"
+                    },
+                    {
+                        "name": "UpdateWithdrawTicketIssuanceEnabled"
+                    },
+                    {
+                        "name": "UpdateWithdrawTicketRedemptionEnabled"
+                    },
+                    {
+                        "name": "UpdateMinWithdrawQueuedLiquidityValue"
+                    },
+                    {
+                        "name": "UpdateFixedRolloverWindowDurationSeconds"
+                    },
+                    {
+                        "name": "UpdateVariableRolloverWindowDurationSeconds"
+                    },
+                    {
+                        "name": "UpdateObligationBorrowRolloverConfigurationEnabled"
                     }
                 ]
             }
@@ -4793,7 +5424,7 @@
                             "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."
+                            "If zeroed, then only open-term reserves may be used."
                         ],
                         "type": "u64"
                     },
@@ -4866,6 +5497,79 @@
                 ]
             }
         },
+        {
+            "name": "FixedTermBorrowRolloverConfig",
+            "docs": [
+                "Settings driving the auto-rollover of an [ObligationLiquidity] that uses a fixed-term [Reserve]",
+                "and approaches the end of its [ReserveConfig::debt_term_seconds].",
+                "",
+                "By its nature (not a special case), the zeroed struct mean \"no auto-rollover\"."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "autoRolloverEnabled",
+                        "docs": [
+                            "Whether the borrow can be permissionlessly prolonged under the following *joint* conditions:",
+                            "",
+                            "The reserve used to re-borrow the liquidity must have:",
+                            "A) the exact same maximum borrow rate as the current one,",
+                            "B) the exact same debt term as the current one,",
+                            "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].",
+                            "",
+                            "Note: the other settings are only effective when this one is `1`."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "openTermAllowed",
+                        "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.",
+                            "",
+                            "Note: typically this flag should be used together with [Self::max_borrow_rate_bps] set to",
+                            "`u32::MAX` (to denote a variable-rate reserve)."
+                        ],
+                        "type": "u8"
+                    },
+                    {
+                        "name": "alignmentPadding",
+                        "docs": [
+                            "Internal alignment padding (free to reuse)."
+                        ],
+                        "type": {
+                            "array": [
+                                "u8",
+                                2
+                            ]
+                        }
+                    },
+                    {
+                        "name": "maxBorrowRateBps",
+                        "docs": [
+                            "A customization setting that can lift the condition *A* from [Self::auto_rollover_enabled]:",
+                            "when not zeroed, the rollover may use a reserve with a maximum borrow rate equal or lower",
+                            "than the given one."
+                        ],
+                        "type": "u32"
+                    },
+                    {
+                        "name": "minDebtTermSeconds",
+                        "docs": [
+                            "A customization setting that can lift the condition *B* from [Self::auto_rollover_enabled]:",
+                            "when not zeroed, the rollover may use a reserve with a *fixed* debt term equal or longer",
+                            "than the given one."
+                        ],
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
         {
             "name": "InitObligationArgs",
             "type": {
@@ -4999,12 +5703,22 @@
                         ],
                         "type": "u64"
                     },
+                    {
+                        "name": "fixedTermBorrowRolloverConfig",
+                        "docs": [
+                            "The user's auto-rollover opt-ins - only effective when this borrow is fixed-term (i.e. its",
+                            "reserve has a non-zero [ReserveConfig::debt_term_seconds])."
+                        ],
+                        "type": {
+                            "defined": "FixedTermBorrowRolloverConfig"
+                        }
+                    },
                     {
                         "name": "padding2",
                         "type": {
                             "array": [
                                 "u64",
-                                7
+                                5
                             ]
                         }
                     }
@@ -5620,9 +6334,13 @@
                         "type": "publicKey"
                     },
                     {
-                        "name": "availableAmount",
+                        "name": "totalAvailableAmount",
                         "docs": [
-                            "Reserve liquidity available"
+                            "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()]."
                         ],
                         "type": "u64"
                     },
@@ -5752,6 +6470,41 @@
                 ]
             }
         },
+        {
+            "name": "WithdrawQueue",
+            "docs": [
+                "A tracker of ticket-based withdrawals."
+            ],
+            "type": {
+                "kind": "struct",
+                "fields": [
+                    {
+                        "name": "queuedCollateralAmount",
+                        "docs": [
+                            "The part of [ReserveLiquidity::total_available_amount] locked for ticketed withdrawals."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "nextIssuedTicketSequenceNumber",
+                        "docs": [
+                            "The sequence number of the next ticket to be issued when enqueueing to withdraw.",
+                            "Note: it is also a number of tickets issued so far."
+                        ],
+                        "type": "u64"
+                    },
+                    {
+                        "name": "nextWithdrawableTicketSequenceNumber",
+                        "docs": [
+                            "The sequence number of the next ticket to be used for actually transferring the withdrawn",
+                            "liquidity (assuming it is available in the reserve).",
+                            "Note: it is also a number of fully-consumed tickets so far."
+                        ],
+                        "type": "u64"
+                    }
+                ]
+            }
+        },
         {
             "name": "WithdrawalCaps",
             "docs": [
@@ -5974,6 +6727,31 @@
                 ]
             }
         },
+        {
+            "name": "ProgressCallbackType",
+            "docs": [
+                "A callback to be notified when the ticket is being processed.",
+                "",
+                "## Why an enum?",
+                "",
+                "Only reliable programs may be used for callbacks (since any error or panic returned from a CPI",
+                "aborts an entire transaction, which would stall the queue progress). Hence, we need a whitelist,",
+                "and the simplest initial implementation is a hardcoded enum. If we want to be able to add new",
+                "whitelist items without SC updates, we can implement such support using a special enum value",
+                "(e.g. `SPECIFIED_BY_PDA = 255`)."
+            ],
+            "type": {
+                "kind": "enum",
+                "variants": [
+                    {
+                        "name": "None"
+                    },
+                    {
+                        "name": "KlendQueueAccountingHandlerOnKvault"
+                    }
+                ]
+            }
+        },
         {
             "name": "BorrowRateCurve",
             "type": {
@@ -6806,6 +7584,56 @@
             "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)"
+        },
+        {
+            "code": 6144,
+            "name": "WithdrawTicketIssuanceDisabled",
+            "msg": "Issuing new withdraw tickets is disabled by the market"
+        },
+        {
+            "code": 6145,
+            "name": "WithdrawTicketRedemptionDisabled",
+            "msg": "Redeeming withdraw tickets is disabled by the market"
+        },
+        {
+            "code": 6146,
+            "name": "WithdrawTicketStillValid",
+            "msg": "Recovering collateral is only available after the withdraw ticket has been marked invalid"
+        },
+        {
+            "code": 6147,
+            "name": "WithdrawTicketRequiresFullRedemption",
+            "msg": "The withdraw ticket's current state requires that it is fully redeemed (e.g. due to owner ATA creation), but there is not enough liquidity"
+        },
+        {
+            "code": 6148,
+            "name": "UserTokenBalanceMismatch",
+            "msg": "The user's token account has changed its balance in an unexpected way"
+        },
+        {
+            "code": 6149,
+            "name": "WithdrawQueuedLiquidityValueTooSmall",
+            "msg": "Available liquidity could not satisfy the minimum required ticketed withdrawal value"
+        },
+        {
+            "code": 6150,
+            "name": "InvalidTokenAccountState",
+            "msg": "Token account is in a state preventing the handler's operation (e.g. frozen or delegate)"
+        },
+        {
+            "code": 6151,
+            "name": "WithdrawTicketInvalid",
+            "msg": "Cannot use ticket that was already marked invalid"
+        },
+        {
+            "code": 6152,
+            "name": "InvalidWithdrawTicketProgressCallbackConfig",
+            "msg": "Invalid configuration or required custom accounts for the requested withdraw ticket callback type"
+        },
+        {
+            "code": 6153,
+            "name": "WithdrawTicketProgressCallbackAccountsMissing",
+            "msg": "One or more accounts required by the ticket's configured progress callback are missing"
         }
     ]
 }