@kamino-finance/klend-sdk 2.13.9 → 3.0.0

package/README_KAMINO_MANAGER.md

@@ -0,0 +1,69 @@
+## Kamino Manager CLI
+
+In order to use the CLI, the followign `.env` configuration is required:
+```
+ADMIN="../staging_owner.json"
+RPC="https://rpc.ironforge.network/mainnet?apiKey=01HVK9A9XRZWKKDZMDDD94R5J6"
+KLEND_PROGRAM_ID_MAINNET="KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"
+KVAULT_PROGRAM_ID_MAINNET="kvauTFR8qm1dhniz6pYuBZkuene3Hfrs1VQhVRgCNrr"
+KLEND_PROGRAM_ID_STAGING="SLendK7ySfcEzyaFqy93gDnD3RtrpXJcnRwb6zFHJSh"
+KVAULT_PROGRAM_ID_STAGING="STkvh7ostar39Fwr4uZKASs1RNNuYMFMTsE77FiRsL2"
+```
+
+#### Create a new market
+`npx ts-node src/client_kamino_manager.ts create-market --staging`
+
+- bs58 - is a boolean flag. If set it will print the bs58 txn instead of executing. Should be used for multisig
+- staging - is a boolean flag. If set, staging programs will be used
+- multisig - address string to be used as admin PublicKey. To be used in conjunction with bs58 flag
+
+#### Add a new asset to market / Create new reserve
+`npx ts-node src/client_kamino_manager.ts add-asset-to-market --market market_address --mint token_mint --mint-program-id TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA --reserve-config-path ./configs/reserve_config_example.json --staging`
+
+- market - address to create the reserve for
+- mint - the liquidity mint to create the reserve for
+- mint-program-id - the program id of the mint - `TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA` - spl token program `TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb` - for token 2022 token program
+- bs58 - is a boolean flag. If set it will print the bs58 txn instead of executing. Should be used for multisig
+- staging - is a boolean flag. If set, staging programs will be used
+- multisig - address string to be used as admin PublicKey. To be used in conjunction with bs58 flag
+
+#### Update a reserve config
+`npx ts-node src/client_kamino_manager.ts update-reserve-config --reserve reserve_address --reserve-config-path ./configs/reserve_config_example.json --staging --update-entire-config`
+
+- reserve - address to update the reserve config for
+- reserve-config-path - the path to the config file to be used
+- update-entire-config - wether to update the entrie reserve config or just the difference between current on-chain state and given config
+- bs58 - is a boolean flag. If set it will print the bs58 txn instead of executing. Should be used for multisig
+- staging - is a boolean flag. If set, staging programs will be used
+
+#### Download a reserve config
+
+In order to update a reserve config, you need the latest reserve configuration, to modify. To get the latest, this command can be used:
+
+`npx ts-node src/client_kamino_manager.ts download-reserve-config --reserve reserve_address --staging`
+
+- reserve - address to update the reserve config for
+- staging - is a boolean flag. If set, staging programs will be used
+
+#### Create a vault 
+`npx ts-node src/client_kamino_manager.ts create-vault --mint token_mint --staging`
+
+- mint - the liquidity mint to create the reserve for
+- bs58 - is a boolean flag. If set it will print the bs58 txn instead of executing. Should be used for multisig
+- staging - is a boolean flag. If set, staging programs will be used
+- multisig - address string to be used as admin PublicKey. To be used in conjunction with bs58 flag
+
+#### Update vault reserve allocation
+`npx ts-node src/client_kamino_manager.ts update-vault-reserve-allocation --vault vault_address --reserve reserve_address --allocation-weight number --allocation-cap number --staging`
+
+- vault - the vault address to add/update the reserve allocation for
+- reserve - the reserve address to add/update the reserve allocation for
+- allocation-weight - the allocation weight for given reserve; only relevant in relation with the other reserve allocation weights
+- allocation-cap - the allocation cap in decimal (not lamports) for given reserve
+- bs58 - is a boolean flag. If set it will print the bs58 txn instead of executing. Should be used for multisig
+- staging - is a boolean flag. If set, staging programs will be used
+- multisig - address string to be used as admin PublicKey. To be used in conjunction with bs58 flag
+
+#### Get oracle mappings 
+This can be used to get scope oracle mappings to be used when configuring the reserve oracle config.
+`npx ts-node src/client_kamino_manager.ts get-oracle-mappings`

package/dist/classes/action.js

@@ -622,7 +622,6 @@ class KaminoAction {
         }, this.kaminoMarket.programId));
     }
     addBorrowIx() {
-        var _a;
         this.lendingIxsLabels.push(`borrowObligationLiquidity`);
         const depositReservesList = this.getAdditionalDepositReservesList();
         const depositReserveAccountMetas = depositReservesList.map((reserve) => {
@@ -644,9 +643,10 @@ class KaminoAction {
             tokenProgram: this.reserve.getLiquidityTokenProgram(),
             instructionSysvarAccount: web3_js_1.SYSVAR_INSTRUCTIONS_PUBKEY,
         }, this.kaminoMarket.programId);
-        borrowIx.keys = ((_a = this.obligation) === null || _a === void 0 ? void 0 : _a.state.elevationGroup)
-            ? borrowIx.keys.concat([...depositReserveAccountMetas])
-            : borrowIx.keys;
+        borrowIx.keys =
+            this.obligation.state.elevationGroup > 0 || this.obligation.refreshedStats.potentialElevationGroupUpdate > 0
+                ? borrowIx.keys.concat([...depositReserveAccountMetas])
+                : borrowIx.keys;
         this.lendingIxs.push(borrowIx);
     }
     addDepositAndBorrowIx() {
@@ -791,7 +791,6 @@ class KaminoAction {
     }
     addRepayIx() {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a;
             this.lendingIxsLabels.push(`repayObligationLiquidity(reserve=${this.reserve.address})(obligation=${this.getObligationPda()})`);
             const depositReservesList = this.getAdditionalDepositReservesList();
             const depositReserveAccountMetas = depositReservesList.map((reserve) => {
@@ -811,13 +810,12 @@ class KaminoAction {
                 instructionSysvarAccount: web3_js_1.SYSVAR_INSTRUCTIONS_PUBKEY,
             }, this.kaminoMarket.programId);
             repayIx.keys =
-                ((_a = this.obligation) === null || _a === void 0 ? void 0 : _a.state.elevationGroup) !== 0 ? repayIx.keys.concat([...depositReserveAccountMetas]) : repayIx.keys;
+                this.obligation.state.elevationGroup > 0 ? repayIx.keys.concat([...depositReserveAccountMetas]) : repayIx.keys;
             this.lendingIxs.push(repayIx);
         });
     }
     addLiquidateIx() {
         return __awaiter(this, arguments, void 0, function* (maxAllowedLtvOverridePercent = 0) {
-            var _a;
             this.lendingIxsLabels.push(`liquidateObligationAndRedeemReserveCollateral`);
             if (!this.outflowReserve) {
                 throw Error(`Withdraw reserve during liquidation is not defined`);
@@ -857,7 +855,7 @@ class KaminoAction {
                 instructionSysvarAccount: web3_js_1.SYSVAR_INSTRUCTIONS_PUBKEY,
             }, this.kaminoMarket.programId);
             liquidateIx.keys =
-                ((_a = this.obligation) === null || _a === void 0 ? void 0 : _a.state.elevationGroup) !== 0
+                this.obligation.state.elevationGroup > 0
                     ? liquidateIx.keys.concat([...depositReserveAccountMetas])
                     : liquidateIx.keys;
             this.lendingIxs.push(liquidateIx);
@@ -1033,12 +1031,22 @@ class KaminoAction {
                         throw new Error(`Could not decide on refresh farm for action ${action}`);
                     }
                 }
-                if (action === 'depositAndBorrow' && requestElevationGroup) {
-                    const groupsColl = this.reserve.state.config.elevationGroups;
-                    const groupsDebt = this.outflowReserve.state.config.elevationGroups;
+                if ((action === 'depositAndBorrow' || action === 'borrow') && requestElevationGroup) {
+                    let emodeGroupsDebt = this.reserve.state.config.elevationGroups;
+                    let emodeGroupsColl = this.reserve.state.config.elevationGroups;
+                    let debtReserve = this.reserve.address;
+                    if (action === 'depositAndBorrow') {
+                        emodeGroupsDebt = this.outflowReserve.state.config.elevationGroups;
+                        debtReserve = this.outflowReserve.address;
+                    }
+                    else if (action === 'borrow') {
+                        const depositReserve = this.obligation.state.deposits.find((x) => !x.depositReserve.equals(web3_js_1.PublicKey.default)).depositReserve;
+                        const collReserve = this.kaminoMarket.getReserveByAddress(depositReserve);
+                        emodeGroupsColl = collReserve.state.config.elevationGroups;
+                    }
                     const groups = this.kaminoMarket.state.elevationGroups;
-                    const commonElevationGroups = [...groupsColl].filter((item) => groupsDebt.includes(item) && item !== 0 && groups[item - 1].debtReserve.equals(this.outflowReserve.address));
-                    console.log('Groups of coll reserve', groupsColl, 'Groups of debt reserve', groupsDebt, 'Common groups', commonElevationGroups);
+                    const commonElevationGroups = [...emodeGroupsColl].filter((item) => emodeGroupsDebt.includes(item) && item !== 0 && groups[item - 1].debtReserve.equals(debtReserve));
+                    console.log('Groups of coll reserve', emodeGroupsColl, 'Groups of debt reserve', emodeGroupsDebt, 'Common groups', commonElevationGroups);
                     if (commonElevationGroups.length === 0) {
                         console.log('No common elevation groups found, staying with default');
                     }
@@ -1050,8 +1058,13 @@ class KaminoAction {
                         });
                         const eModeGroup = groups.find((group) => group.id === eModeGroupWithMaxLtvAndDebtReserve).id;
                         console.log('Setting eModeGroup to', eModeGroup);
+                        let addToSetupIxs = false;
                         if (eModeGroup !== 0 && eModeGroup !== ((_a = this.obligation) === null || _a === void 0 ? void 0 : _a.state.elevationGroup)) {
-                            this.addRequestElevationIx(eModeGroup, false);
+                            if (action === 'borrow') {
+                                this.obligation.refreshedStats.potentialElevationGroupUpdate = eModeGroup;
+                                addToSetupIxs = true;
+                            }
+                            this.addRequestElevationIx(eModeGroup, addToSetupIxs);
                             this.addRefreshReserveIxs(allReservesExcludingCurrent, addToSetupIxs);
                             this.addRefreshReserveIxs(currentReserveAddresses.toArray(), addToSetupIxs);
                             this.addRefreshObligationIx(addToSetupIxs);