@kamino-finance/klend-sdk 8.0.2 → 8.0.3

package/dist/classes/action.d.ts

@@ -8,7 +8,7 @@ import { KaminoReserve } from './reserve';
 import { ProgressCallbackType } from '../@codegen/klend/types';
 import { Scope } from '@kamino-finance/scope-sdk';
 import { ObligationOrderAtIndex } from './obligationOrder';
-import { BuildDepositTxnsProps, BuildBorrowTxnsProps, BuildBorrowRolloverConfigIxsProps, BuildDepositReserveLiquidityTxnsProps, BuildRedeemReserveCollateralTxnsProps, BuildWithdrawTxnsProps, BuildWithdrawFromObligationAndEnqueueTxnsProps, BuildRepayTxnsProps, BuildDepositAndBorrowTxnsProps, BuildRefreshObligationTxnsProps, BuildRequestElevationGroupTxnsProps, BuildDepositAndWithdrawV2TxnsProps, BuildRepayAndWithdrawTxnsProps, BuildRepayAndWithdrawV2TxnsProps, BuildLiquidateTxnsProps, BuildWithdrawReferrerFeeTxnsProps, BuildDepositObligationCollateralTxnsProps, BuildDepositAndSetBorrowOrderTxnsProps, InitializeActionProps } from './actionTypes';
+import { BuildDepositTxnsProps, BuildBorrowTxnsProps, BuildBorrowRolloverConfigIxsProps, BuildDepositReserveLiquidityTxnsProps, BuildRedeemReserveCollateralTxnsProps, BuildWithdrawTxnsProps, BuildWithdrawFromObligationAndEnqueueTxnsProps, BuildRepayTxnsProps, BuildDepositAndBorrowTxnsProps, BuildRefreshObligationTxnsProps, BuildRolloverFixedTermBorrowTxnsProps, BuildRequestElevationGroupTxnsProps, BuildDepositAndWithdrawV2TxnsProps, BuildRepayAndWithdrawTxnsProps, BuildRepayAndWithdrawV2TxnsProps, BuildLiquidateTxnsProps, BuildWithdrawReferrerFeeTxnsProps, BuildDepositObligationCollateralTxnsProps, BuildDepositAndSetBorrowOrderTxnsProps, InitializeActionProps } from './actionTypes';
 export type ActionType = 'deposit' | 'borrow' | 'withdraw' | 'repay' | 'mint' | 'redeem' | 'depositCollateral' | 'liquidate' | 'depositAndBorrow' | 'repayAndWithdraw' | 'refreshObligation' | 'requestElevationGroup' | 'withdrawReferrerFees' | 'repayAndWithdrawV2' | 'depositAndWithdraw' | 'withdrawAndEnqueue' | 'setBorrowOrder' | 'fillBorrowOrder';
 export type AuxiliaryIx = 'setup' | 'inBetween' | 'cleanup';
 export declare class KaminoAction {
@@ -55,6 +55,36 @@ export declare class KaminoAction {
     static buildRequestElevationGroupTxns(props: BuildRequestElevationGroupTxnsProps): Promise<KaminoAction>;
     static buildDepositTxns(props: BuildDepositTxnsProps): Promise<KaminoAction>;
     static buildDepositAndSetBorrowOrderTxns(props: BuildDepositAndSetBorrowOrderTxnsProps): Promise<KaminoAction>;
+    /**
+     * Builds a transaction that rolls an existing borrow over from one reserve into another (the
+     * `rolloverFixedTermBorrow` instruction). The target reserve may be fixed-term or variable/open-term.
+     * The program requires a single signer (the `payer`) but not specifically the obligation owner, so the
+     * transaction can be signed by the owner directly or cranked by a keeper.
+     *
+     * The returned action includes the setup refresh/farm-init instructions and the rollover instruction.
+     * The program enforces several additional rollover preconditions at execution time (shared liquidity
+     * mint, rollover config opt-in, matching borrow factor, target rate/term limits, the market's rollover
+     * execution window, etc.) that this method does not pre-validate; a violation fails the transaction.
+     * Rollover is configured on the borrow via {@link KaminoAction.buildBorrowRolloverConfigIxs}.
+     */
+    static buildRolloverFixedTermBorrowTxns(props: BuildRolloverFixedTermBorrowTxnsProps): Promise<KaminoAction>;
+    /**
+     * Emits the setup instructions for a rollover: refreshes every reserve the obligation touches (plus the
+     * source and target), then refreshes the obligation. No farm-refresh instructions are emitted - the
+     * `rolloverFixedTermBorrow` handler refreshes the source and target debt farms internally. The source's
+     * and target's debt obligation farm-user-states are initialized first if missing, since that internal
+     * refresh loads them and fails if absent (the source's usually already exists from its borrow, but not
+     * guaranteed if its debt farm was added later); both inits are idempotent no-ops when already present.
+     *
+     * When a {@link ScopePriceRefreshConfig} is provided, the Scope price refresh is prepended so the reserve
+     * refreshes below (which read the Scope feed) succeed for Scope-priced reserves.
+     */
+    private addRolloverFixedTermBorrowSupportIxs;
+    /**
+     * Appends the `rolloverFixedTermBorrow` instruction, resolving the source/target reserve vaults and
+     * their debt-farm accounts (the on-chain handler refreshes debt farms only).
+     */
+    private addRolloverFixedTermBorrowIx;
     addScopeRefreshIxs(scope: Scope, tokens: number[], scopeConfig: Address): Promise<void>;
     /**
      * Add the opt-in borrow support instructions used when creating and filling a borrow order from vaults.
@@ -184,7 +214,7 @@ export declare class KaminoAction {
     addRepayAndWithdrawIxsV2(withdrawCollateralAmount: BN): Promise<void>;
     addLiquidateIx(maxAllowedLtvOverridePercent?: number): Promise<void>;
     addLiquidateIxV2(maxAllowedLtvOverridePercent?: number): Promise<void>;
-    addInBetweenIxs(action: ActionType, includeAtaIxs: boolean, requestElevationGroup: boolean, addInitObligationForFarm: boolean, useV2Ixs: boolean): Promise<void>;
+    addInBetweenIxs(action: ActionType, includeAtaIxs: boolean, requestElevationGroup: boolean, addInitObligationForFarm: boolean, useV2Ixs: boolean, overrideElevationGroupRequest?: number): Promise<void>;
     addRefreshObligation(crank: TransactionSigner): Promise<void>;
     addSupportIxsWithoutInitObligation(action: ActionType, includeAtaIxs: boolean, useV2Ixs: boolean, addAsSupportIx?: AuxiliaryIx, requestElevationGroup?: boolean, addInitObligationForFarm?: boolean, twoTokenAction?: boolean, overrideElevationGroupRequest?: number): Promise<void>;
     addSupportIxs(action: ActionType, includeAtaIxs: boolean, requestElevationGroup: boolean, addInitObligationForFarm: boolean, useV2Ixs: boolean, scopeRefreshConfig: ScopePriceRefreshConfig | undefined, initUserMetadata: {
@@ -205,6 +235,20 @@ export declare class KaminoAction {
     private addRefreshFarmsForReserve;
     private addRefreshFarmsCleanupTxnIxsToCleanupIxs;
     private addInitObligationForFarm;
+    /**
+     * Appends already-built init-obligation-for-farm instructions (from {@link buildInitObligationForFarmIxs}) to
+     * the setup or in-between ix list. Callers that build several reserves' ixs concurrently use this to append
+     * them in a deterministic order afterwards.
+     */
+    private pushInitObligationForFarmIxs;
+    /**
+     * Builds the `initObligationFarmsForReserve` instruction(s) needed for this reserve's farm of the given kind,
+     * without mutating the action. Returns an entry only when the reserve has that farm and the obligation's
+     * farm-user-state does not yet exist (so it is a no-op when already initialized); at most one entry today.
+     * Being side-effect free, it lets callers fetch the existence checks for several reserves concurrently and
+     * then append the resulting ixs in a deterministic order via {@link pushInitObligationForFarmIxs}.
+     */
+    private buildInitObligationForFarmIxs;
     private addInitObligationIxs;
     private addInitUserMetadataIxs;
     private addInitReferrerTokenStateIx;

package/dist/classes/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/classes/action.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/classes/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EAEP,WAAW,EACX,WAAW,EAIX,MAAM,EACN,IAAI,EAEJ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,OAAO,CAAC;AAgDvB,OAAO,EAWL,cAAc,EAGd,uBAAuB,EAMxB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAA8B,YAAY,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAsB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAA+C,MAAM,yBAAyB,CAAC;AAG5G,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAU3D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iCAAiC,EACjC,qCAAqC,EACrC,qCAAqC,EACrC,sBAAsB,EACtB,8CAA8C,EAC9C,mBAAmB,EACnB,8BAA8B,EAC9B,+BAA+B,EAC/B,qCAAqC,EACrC,mCAAmC,EACnC,kCAAkC,EAClC,8BAA8B,EAC9B,gCAAgC,EAChC,uBAAuB,EACvB,iCAAiC,EACjC,yCAAyC,EACzC,sCAAsC,EACtC,qBAAqB,EAEtB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,OAAO,GACP,MAAM,GACN,QAAQ,GACR,mBAAmB,GACnB,WAAW,GACX,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,uBAAuB,GACvB,sBAAsB,GACtB,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D,qBAAa,YAAY;IACvB,YAAY,EAAE,YAAY,CAAC;IAE3B,OAAO,EAAE,aAAa,CAAC;IAEvB,cAAc,EAAE,aAAa,GAAG,SAAS,CAAC;IAE1C,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,iBAAiB,CAAC;IAEzB,UAAU,EAAE,gBAAgB,GAAG,cAAc,CAAC;IAE9C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1B;;OAEG;IACH,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;IAE7C,IAAI,EAAE,OAAO,CAAC;IAEd,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE,EAAE,CAAC;IACX,aAAa,CAAC,EAAE,EAAE,CAAC;IAEnB,gBAAgB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,sBAAsB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEtC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAErB,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACjC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAElC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEhC,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACnC,oBAAoB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEpC,UAAU,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEhC,yBAAyB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC9C,+BAA+B,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAE/B,8BAA8B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAE/C,WAAW,EAAE,IAAI,CAAC;IAElB,OAAO;WAkDM,UAAU,CAAC,KAAK,EAAE,qBAAqB;mBA0C/B,uBAAuB;mBAmBvB,cAAc;WA+CtB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B;WA2BjE,8BAA8B,CAAC,KAAK,EAAE,mCAAmC;WA2BzE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB;WAyD7C,iCAAiC,CAAC,KAAK,EAAE,sCAAsC;IAmB5F;;;;;;;;;;;OAWG;WACU,gCAAgC,CAAC,KAAK,EAAE,qCAAqC;IAoD1F;;;;;;;;;;OAUG;YACW,oCAAoC;IAuClD;;;OAGG;YACW,4BAA4B;IA4CpC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,OAAO;IAQ7E;;;;OAIG;IACG,wBAAwB,CAC5B,kBAAkB,EAAE,uBAAuB,GAAG,SAAS,EACvD,gBAAgB,GAAE;QAAE,kBAAkB,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAGxE,EACD,qBAAqB,GAAE,OAAe,EACtC,6BAA6B,CAAC,EAAE,MAAM;WAkB3B,eAAe,CAAC,KAAK,EAAE,oBAAoB;WAwE3C,gCAAgC,CAAC,KAAK,EAAE,qCAAqC;WA6C7E,gCAAgC,CAAC,KAAK,EAAE,qCAAqC;WA6C7E,oCAAoC,CAAC,KAAK,EAAE,yCAAyC;WAkDrF,yBAAyB,CAAC,KAAK,EAAE,8BAA8B;WAkH/D,6BAA6B,CAAC,KAAK,EAAE,kCAAkC;WAoDvE,2BAA2B,CAAC,KAAK,EAAE,gCAAgC;WAoDnE,yBAAyB,CAAC,KAAK,EAAE,8BAA8B;WAuF/D,iBAAiB,CAAC,KAAK,EAAE,sBAAsB;WA6D/C,yCAAyC,CAAC,KAAK,EAAE,8CAA8C;IAmE5G;;;OAGG;WACU,cAAc,CAAC,KAAK,EAAE,mBAAmB;WAsDzC,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;WA0DzE,4BAA4B,CAAC,KAAK,EAAE,iCAAiC;IA6BlF;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAC/B,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,EAC5B,YAAY,EAAE,sBAAsB,GACnC,WAAW;IAgBd;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,2CAA2C,CAChD,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,OAAO,GAChB,WAAW;IAad;;;;;;;OAOG;WACU,0CAA0C,CACrD,WAAW,EAAE,iBAAiB,EAC9B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,EAC5B,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,WAAW,CAAC;IAcvB;;;;OAIG;IACH,MAAM,CAAC,iCAAiC,CACtC,YAAY,EAAE,iBAAiB,EAC/B,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,GAC3B,WAAW;IAYd;;;;OAIG;IACH,MAAM,CAAC,wCAAwC,CAC7C,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,GAC3B,WAAW;IAYd;;;OAGG;WACU,wBAAwB,CACnC,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,EAAE,EACpB,0BAA0B,EAAE,OAAO,EACnC,oBAAoB,GAChB,oBAAoB,CAAC,IAAI,GACzB,oBAAoB,CAAC,mCAAqE,EAC9F,8BAA8B,GAAE,MAAM,CAAC,OAAO,CAAU,EACxD,8BAA8B,GAAE,MAAM,CAAC,OAAO,CAAU,GACvD,OAAO,CAAC,WAAW,CAAC;IAyCvB;;;OAGG;WACU,8BAA8B,CACzC,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,OAAO,EACvB,mBAAmB,EAAE,OAAO,EAC5B,wBAAwB,EAAE,OAAO,EACjC,uBAAuB,GAAE,MAAM,CAAC,OAAO,CAAU,EACjD,8BAA8B,GAAE,MAAM,CAAC,OAAO,CAAU,EACxD,8BAA8B,GAAE,MAAM,CAAC,OAAO,CAAU,GACvD,OAAO,CAAC,WAAW,CAAC;IA4CvB;;;;;;;;;OASG;WACU,sBAAsB,CACjC,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,GAAG,OAAO,EACtC,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,qCAAqC,GAAE,EAAc,GACpD,OAAO,CAAC,WAAW,EAAE,CAAC;IA4DzB;;;;;;;OAOG;WACU,sBAAsB,CACjC,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC;IA+CjB,4BAA4B;IA2B5B,4BAA4B;IA4B5B,YAAY;IA6BZ,cAAc;IAuCd,gCAAgC;IAuBhC,kCAAkC;IAoClC,WAAW;IAyCX,aAAa;IAoDnB;;;;;OAKG;IACH,MAAM,CAAC,4BAA4B,CAAC,KAAK,EAAE,iCAAiC,GAAG,WAAW,EAAE;YA4D9E,0BAA0B;IAgBlC,aAAa,CAAC,gBAAgB,EAAE,EAAE;IA6BlC,eAAe,CAAC,gBAAgB,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCpD,mCAAmC,CAAC,gBAAgB,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCxE,UAAU;IA0CV,YAAY;IAsDZ,wBAAwB,CAAC,wBAAwB,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqFrE,0BAA0B,CAAC,wBAAwB,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FvE,qBAAqB;IA2ErB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgGxC,sBAAsB,CAAC,wBAAwB,EAAE,EAAE;IAwEnD,wBAAwB,CAAC,wBAAwB,EAAE,EAAE;IAqGrD,cAAc,CAAC,4BAA4B,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDvE,gBAAgB,CAAC,4BAA4B,GAAE,MAAU;IA0EzD,eAAe,CACnB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,OAAO,EACtB,qBAAqB,EAAE,OAAO,EAC9B,wBAAwB,EAAE,OAAO,EACjC,QAAQ,EAAE,OAAO,EACjB,6BAA6B,CAAC,EAAE,MAAM;IAclC,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D,kCAAkC,CACtC,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,OAAO,EACtB,QAAQ,EAAE,OAAO,EACjB,cAAc,GAAE,WAAqB,EACrC,qBAAqB,GAAE,OAAe,EACtC,wBAAwB,GAAE,OAAe,EACzC,cAAc,GAAE,OAAe,EAC/B,6BAA6B,CAAC,EAAE,MAAM;IA+PlC,aAAa,CACjB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,OAAO,EACtB,qBAAqB,EAAE,OAAO,EAC9B,wBAAwB,EAAE,OAAO,EACjC,QAAQ,EAAE,OAAO,EACjB,kBAAkB,EAAE,uBAAuB,GAAG,SAAS,EACvD,gBAAgB,EAAE;QAAE,kBAAkB,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,EAC3E,cAAc,GAAE,OAAe,EAC/B,6BAA6B,CAAC,EAAE,MAAM;IAqBxC,OAAO,CAAC,8BAA8B;YAYxB,yBAAyB;YAazB,uBAAuB;YAevB,4BAA4B;IAuB1C,OAAO,CAAC,8BAA8B;IAwBtC,OAAO,CAAC,uCAAuC;IAe/C,OAAO,CAAC,MAAM,CAAC,eAAe;IAQ9B,OAAO,CAAC,oBAAoB;WAuCd,qBAAqB,CAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;YAuBrF,sBAAsB;YA6DtB,qBAAqB;YA+DrB,yBAAyB;IAuGvC,OAAO,CAAC,wCAAwC;YAKlC,wBAAwB;IAQtC;;;;OAIG;IACH,OAAO,CAAC,4BAA4B;IAYpC;;;;;;OAMG;YACW,6BAA6B;YAwD7B,oBAAoB;YA8BpB,sBAAsB;IA0BpC,OAAO,CAAC,2BAA2B;YAqBrB,0BAA0B;IA2BxC,OAAO,CAAC,kBAAkB;YAKZ,SAAS;YAyGT,iBAAiB;WAgHlB,0BAA0B,CACrC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,MAAM,GAAG,EAAE,EACzB,oBAAoB,EAAE,OAAO,EAC7B,qBAAqB,EAAE,OAAO,EAC9B,MAAM,EAAE,iBAAiB,EACzB,eAAe,EAAE,OAAO,EACxB,UAAU,EAAE,gBAAgB,GAAG,cAAc,EAC7C,aAAa,EAAE,MAAM,GAAG,EAAE,GAAG,SAAS,EACtC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EACzB,WAAW,EAAE,IAAI;WAiDN,8BAA8B,CACzC,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,iBAAiB,EACxB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,IAAI;;;;IAoCnB,2BAA2B,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE;IAW7D,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAM1C,uBAAuB;IAIvB,gCAAgC,IAAI,OAAO,EAAE;mBAsBxB,0BAA0B;YAWjC,gCAAgC;YAchC,4BAA4B;IAI1C,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpE,4BAA4B,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF,+BAA+B,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;WAI3D,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;WAQrD,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC;WAW5D,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;WAQrD,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;mBAWrD,yBAAyB;mBAoDzB,cAAc;mBAsBd,gCAAgC;CAUtD"}

package/dist/classes/action.js

@@ -223,6 +223,128 @@ class KaminoAction {
         axn.postLendingIxsLabels.push('setBorrowOrder');
         return axn;
     }
+    /**
+     * Builds a transaction that rolls an existing borrow over from one reserve into another (the
+     * `rolloverFixedTermBorrow` instruction). The target reserve may be fixed-term or variable/open-term.
+     * The program requires a single signer (the `payer`) but not specifically the obligation owner, so the
+     * transaction can be signed by the owner directly or cranked by a keeper.
+     *
+     * The returned action includes the setup refresh/farm-init instructions and the rollover instruction.
+     * The program enforces several additional rollover preconditions at execution time (shared liquidity
+     * mint, rollover config opt-in, matching borrow factor, target rate/term limits, the market's rollover
+     * execution window, etc.) that this method does not pre-validate; a violation fails the transaction.
+     * Rollover is configured on the borrow via {@link KaminoAction.buildBorrowRolloverConfigIxs}.
+     */
+    static async buildRolloverFixedTermBorrowTxns(props) {
+        const { kaminoMarket, obligation, sourceReserveAddress, targetReserveAddress, payer, scopeRefreshConfig, extraComputeBudget = 1_000_000, currentSlot, } = props;
+        const sourceReserve = kaminoMarket.getReserveByAddress(sourceReserveAddress);
+        if (!sourceReserve) {
+            throw new Error(`Source reserve ${sourceReserveAddress} not found in market ${kaminoMarket.getAddress()}`);
+        }
+        const targetReserve = kaminoMarket.getReserveByAddress(targetReserveAddress);
+        if (!targetReserve) {
+            throw new Error(`Target reserve ${targetReserveAddress} not found in market ${kaminoMarket.getAddress()}`);
+        }
+        // The rollover only ever moves liquidity between the two reserves' vaults (it never touches a user
+        // token account), so the program rejects a mint mismatch. Fail early with a clearer message.
+        if (sourceReserve.getLiquidityMint() !== targetReserve.getLiquidityMint()) {
+            throw new Error(`Rollover target reserve ${targetReserveAddress} liquidity mint ${targetReserve.getLiquidityMint()} does not match source reserve ${sourceReserveAddress} mint ${sourceReserve.getLiquidityMint()}`);
+        }
+        const axn = await KaminoAction.initialize({
+            kaminoMarket,
+            action: 'refreshObligation',
+            amount: '0',
+            reserveAddress: sourceReserve.address,
+            // The rollover's only signer is `payer`; this owner slot just supplies the owner pubkey for
+            // PDA/account derivation and never signs (the caller passes the owner as `payer` if they sign).
+            owner: (0, signer_1.noopSigner)(obligation.state.owner),
+            obligation,
+            currentSlot,
+            payer,
+        });
+        if (extraComputeBudget > 0) {
+            axn.addComputeBudgetIx(extraComputeBudget);
+        }
+        await axn.addRolloverFixedTermBorrowSupportIxs(sourceReserve, targetReserve, scopeRefreshConfig);
+        await axn.addRolloverFixedTermBorrowIx(sourceReserve, targetReserve);
+        return axn;
+    }
+    /**
+     * Emits the setup instructions for a rollover: refreshes every reserve the obligation touches (plus the
+     * source and target), then refreshes the obligation. No farm-refresh instructions are emitted - the
+     * `rolloverFixedTermBorrow` handler refreshes the source and target debt farms internally. The source's
+     * and target's debt obligation farm-user-states are initialized first if missing, since that internal
+     * refresh loads them and fails if absent (the source's usually already exists from its borrow, but not
+     * guaranteed if its debt farm was added later); both inits are idempotent no-ops when already present.
+     *
+     * When a {@link ScopePriceRefreshConfig} is provided, the Scope price refresh is prepended so the reserve
+     * refreshes below (which read the Scope feed) succeed for Scope-priced reserves.
+     */
+    async addRolloverFixedTermBorrowSupportIxs(sourceReserve, targetReserve, scopeRefreshConfig) {
+        // The source's and target's existence checks are independent, so run them concurrently; append the ixs
+        // source-then-target afterwards to keep the emitted order deterministic.
+        const [sourceInitIxs, targetInitIxs] = await Promise.all([
+            this.buildInitObligationForFarmIxs(sourceReserve, types_1.ReserveFarmKind.Debt),
+            this.buildInitObligationForFarmIxs(targetReserve, types_1.ReserveFarmKind.Debt),
+        ]);
+        this.pushInitObligationForFarmIxs([...sourceInitIxs, ...targetInitIxs], 'setup');
+        // Refresh every reserve the obligation touches (the source is already among its borrows) plus the
+        // target, which may be new to the obligation.
+        const reservesToRefresh = [
+            ...new Set([...this.depositReserves, ...this.borrowReserves, targetReserve.address]),
+        ];
+        // For Scope-priced reserves the refreshReserve ixs below read the Scope price feed, which must have been
+        // refreshed earlier in the transaction; prepend the Scope refresh covering this same reserve set (the
+        // target included). addScopeRefreshIxs unshifts, so it lands ahead of the reserve refreshes.
+        const scopeTokensMap = (0, market_1.getTokenIdsForScopeRefresh)(this.kaminoMarket, reservesToRefresh);
+        if (scopeTokensMap.size > 0 && scopeRefreshConfig) {
+            for (const [configPubkey, config] of scopeRefreshConfig.scopeConfigurations) {
+                const tokenIds = scopeTokensMap.get(config.oraclePrices);
+                if (tokenIds && tokenIds.length > 0) {
+                    await this.addScopeRefreshIxs(scopeRefreshConfig.scope, tokenIds, configPubkey);
+                }
+            }
+        }
+        this.addRefreshReserveIxs(reservesToRefresh, 'setup');
+        // refresh_obligation only validates the obligation's current reserves, so the target is intentionally
+        // not added here (it is refreshed as a reserve above).
+        await this.addRefreshObligationIx('setup');
+    }
+    /**
+     * Appends the `rolloverFixedTermBorrow` instruction, resolving the source/target reserve vaults and
+     * their debt-farm accounts (the on-chain handler refreshes debt farms only).
+     */
+    async addRolloverFixedTermBorrowIx(sourceReserve, targetReserve) {
+        const farmsProgramId = this.kaminoMarket.farmsProgramId;
+        const [obligationPda, lendingMarketAuthority] = await Promise.all([
+            this.getObligationPda(),
+            this.kaminoMarket.getLendingMarketAuthority(),
+        ]);
+        // Source and target farm accounts are independent, so resolve them concurrently.
+        const [{ debtFarmAccounts: sourceFarmsAccounts }, { debtFarmAccounts: targetFarmsAccounts }] = await Promise.all([
+            KaminoAction.getFarmAccountsForReserve(obligationPda, sourceReserve, farmsProgramId),
+            KaminoAction.getFarmAccountsForReserve(obligationPda, targetReserve, farmsProgramId),
+        ]);
+        const rolloverIx = (0, instructions_1.rolloverFixedTermBorrow)({
+            rolloverAccounts: {
+                payer: this.payer,
+                obligation: obligationPda,
+                lendingMarket: this.kaminoMarket.getAddress(),
+                lendingMarketAuthority,
+                sourceBorrowReserve: sourceReserve.address,
+                targetBorrowReserve: targetReserve.address,
+                liquidityMint: sourceReserve.getLiquidityMint(),
+                sourceBorrowReserveLiquidity: sourceReserve.state.liquidity.supplyVault,
+                targetBorrowReserveLiquidity: targetReserve.state.liquidity.supplyVault,
+                tokenProgram: sourceReserve.getLiquidityTokenProgram(),
+            },
+            sourceFarmsAccounts,
+            targetFarmsAccounts,
+            farmsProgram: farmsProgramId,
+        }, undefined, this.kaminoMarket.programId);
+        this.lendingIxs.push(rolloverIx);
+        this.lendingIxsLabels.push(`rolloverFixedTermBorrow[source=${sourceReserve.address}, target=${targetReserve.address}]`);
+    }
     async addScopeRefreshIxs(scope, tokens, scopeConfig) {
         const refreshIx = await scope.refreshPriceListIx({ config: scopeConfig }, tokens);
         if (refreshIx) {
@@ -357,7 +479,7 @@ class KaminoAction {
         return axn;
     }
     static async buildDepositAndBorrowTxns(props) {
-        const { kaminoMarket, depositAmount, depositReserveAddress, borrowAmount, borrowReserveAddress, owner, obligation, useV2Ixs, scopeRefreshConfig, extraComputeBudget = 1_000_000, includeAtaIxs = true, requestElevationGroup = false, initUserMetadata = { skipInitialization: false, skipLutCreation: false }, referrer = (0, kit_1.none)(), currentSlot, rollOver = false, } = props;
+        const { kaminoMarket, depositAmount, depositReserveAddress, borrowAmount, borrowReserveAddress, owner, obligation, useV2Ixs, scopeRefreshConfig, extraComputeBudget = 1_000_000, includeAtaIxs = true, requestElevationGroup = false, overrideElevationGroupRequest, initUserMetadata = { skipInitialization: false, skipLutCreation: false }, referrer = (0, kit_1.none)(), currentSlot, rollOver = false, } = props;
         const axn = await KaminoAction.initializeMultiTokenAction(kaminoMarket, 'depositAndBorrow', depositAmount, depositReserveAddress, borrowReserveAddress, owner, owner.address, obligation, borrowAmount, referrer, currentSlot);
         const addInitObligationForFarmForDeposit = true;
         const addInitObligationForFarmForBorrow = false;
@@ -379,7 +501,7 @@ class KaminoAction {
         else {
             await axn.addDepositAndBorrowIx();
         }
-        await axn.addInBetweenIxs('depositAndBorrow', includeAtaIxs, requestElevationGroup, addInitObligationForFarmForBorrow, useV2Ixs);
+        await axn.addInBetweenIxs('depositAndBorrow', includeAtaIxs, requestElevationGroup, addInitObligationForFarmForBorrow, useV2Ixs, overrideElevationGroupRequest);
         if (rollOver && axn.outflowReserve?.getKind().isFixedRate()) {
             const obligationAddress = await axn.getObligationPda();
             const rolloverIxs = KaminoAction.buildBorrowRolloverConfigIxs({
@@ -1680,8 +1802,8 @@ class KaminoAction {
         };
         this.lendingIxs.push(liquidateIx);
     }
-    async addInBetweenIxs(action, includeAtaIxs, requestElevationGroup, addInitObligationForFarm, useV2Ixs) {
-        await this.addSupportIxsWithoutInitObligation(action, includeAtaIxs, useV2Ixs, 'inBetween', requestElevationGroup, addInitObligationForFarm);
+    async addInBetweenIxs(action, includeAtaIxs, requestElevationGroup, addInitObligationForFarm, useV2Ixs, overrideElevationGroupRequest) {
+        await this.addSupportIxsWithoutInitObligation(action, includeAtaIxs, useV2Ixs, 'inBetween', requestElevationGroup, addInitObligationForFarm, false, overrideElevationGroupRequest);
     }
     async addRefreshObligation(crank) {
         const uniqueReserveAddresses = [...new Set(this.depositReserves.concat(this.borrowReserves))];
@@ -1994,19 +2116,11 @@ class KaminoAction {
         return newElevationGroup;
     }
     getPreferredElevationGroupForBorrowPair(collReserve, debtReserve) {
-        const commonElevationGroups = this.kaminoMarket.getCommonElevationGroupsForPair(collReserve, debtReserve);
-        if (commonElevationGroups.length === 0) {
+        const selectedElevationGroupId = this.kaminoMarket.getPreferredElevationGroupForBorrowPair(collReserve, debtReserve);
+        if (selectedElevationGroupId === 0) {
             console.log('No common elevation groups found, staying with default');
             return undefined;
         }
-        let selectedElevationGroupId;
-        let selectedMaxLtvPct = -1;
-        for (const group of this.kaminoMarket.state.elevationGroups) {
-            if (commonElevationGroups.includes(group.id) && group.ltvPct > selectedMaxLtvPct) {
-                selectedElevationGroupId = group.id;
-                selectedMaxLtvPct = group.ltvPct;
-            }
-        }
         return selectedElevationGroupId;
     }
     static optionalAccount(pubkey) {
@@ -2218,6 +2332,33 @@ class KaminoAction {
         this.cleanupIxsLabels.splice(0, 0, ...this.refreshFarmsCleanupTxnIxsLabels);
     }
     async addInitObligationForFarm(reserve, mode, addAsSupportIx = 'setup') {
+        this.pushInitObligationForFarmIxs(await this.buildInitObligationForFarmIxs(reserve, mode), addAsSupportIx);
+    }
+    /**
+     * Appends already-built init-obligation-for-farm instructions (from {@link buildInitObligationForFarmIxs}) to
+     * the setup or in-between ix list. Callers that build several reserves' ixs concurrently use this to append
+     * them in a deterministic order afterwards.
+     */
+    pushInitObligationForFarmIxs(initIxs, addAsSupportIx) {
+        for (const { ix, label } of initIxs) {
+            if (addAsSupportIx === 'setup') {
+                this.setupIxs.push(ix);
+                this.setupIxsLabels.push(label);
+            }
+            else if (addAsSupportIx === 'inBetween') {
+                this.inBetweenIxs.push(ix);
+                this.inBetweenIxsLabels.push(label);
+            }
+        }
+    }
+    /**
+     * Builds the `initObligationFarmsForReserve` instruction(s) needed for this reserve's farm of the given kind,
+     * without mutating the action. Returns an entry only when the reserve has that farm and the obligation's
+     * farm-user-state does not yet exist (so it is a no-op when already initialized); at most one entry today.
+     * Being side-effect free, it lets callers fetch the existence checks for several reserves concurrently and
+     * then append the resulting ixs in a deterministic order via {@link pushInitObligationForFarmIxs}.
+     */
+    async buildInitObligationForFarmIxs(reserve, mode) {
         const farms = [];
         const obligationAddress = await this.getObligationPda();
         if (mode === types_1.ReserveFarmKind.Collateral && (0, utils_1.isNotNullPubkey)(reserve.state.farmCollateral)) {
@@ -2235,30 +2376,27 @@ class KaminoAction {
             }
         }
         const lendingMarketAuthority = await this.kaminoMarket.getLendingMarketAuthority();
-        farms.forEach((arg) => {
-            const args = { mode: arg[0] };
+        return farms.map(([modeDiscriminator, reserveFarmState, obligationFarm]) => {
+            const args = { mode: modeDiscriminator };
             const accounts = {
                 owner: (0, obligation_1.isKaminoObligation)(this.obligation) ? this.obligation.state.owner : this.owner.address,
-                payer: this.owner,
+                // The farm user-state account is rent-paid by the transaction's payer, which is not necessarily
+                // the obligation owner (e.g. a keeper-cranked rollover where `owner` is a non-signing noopSigner).
+                payer: this.payer,
                 obligation: obligationAddress,
                 lendingMarketAuthority,
                 reserve: reserve.address,
-                reserveFarmState: arg[1],
-                obligationFarm: arg[2],
+                reserveFarmState,
+                obligationFarm,
                 lendingMarket: this.kaminoMarket.getAddress(),
                 farmsProgram: this.kaminoMarket.farmsProgramId,
                 rent: sysvars_1.SYSVAR_RENT_ADDRESS,
                 systemProgram: system_1.SYSTEM_PROGRAM_ADDRESS,
             };
-            const initObligationForFarm = (0, instructions_1.initObligationFarmsForReserve)(args, accounts, [], this.kaminoMarket.programId);
-            if (addAsSupportIx === 'setup') {
-                this.setupIxs.push(initObligationForFarm);
-                this.setupIxsLabels.push(`InitObligationForFarm[${reserve.address.toString()}, ${obligationAddress.toString()}]`);
-            }
-            else if (addAsSupportIx === 'inBetween') {
-                this.inBetweenIxs.push(initObligationForFarm);
-                this.inBetweenIxsLabels.push(`InitObligationForFarm[${reserve.address.toString()}, ${obligationAddress.toString()}]`);
-            }
+            return {
+                ix: (0, instructions_1.initObligationFarmsForReserve)(args, accounts, [], this.kaminoMarket.programId),
+                label: `InitObligationForFarm[${reserve.address.toString()}, ${obligationAddress.toString()}]`,
+            };
         });
     }
     async addInitObligationIxs() {