@kamino-finance/klend-sdk 2.13.10 → 3.0.1

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="admin.json"
+RPC="https://rpc.cluster"
+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/index.d.ts

@@ -6,3 +6,5 @@ export * from './reserve';
 export * from './shared';
 export * from './utils';
 export * from './jupiterPerps';
+export * from './manager';
+export * from './vault';

package/dist/classes/index.js

@@ -22,4 +22,6 @@ __exportStar(require("./reserve"), exports);
 __exportStar(require("./shared"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./jupiterPerps"), exports);
+__exportStar(require("./manager"), exports);
+__exportStar(require("./vault"), exports);
 //# sourceMappingURL=index.js.map

package/dist/classes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,iDAA+B","sourcesContent":["export * from './action';\nexport * from './curve';\nexport * from './market';\nexport * from './obligation';\nexport * from './reserve';\nexport * from './shared';\nexport * from './utils';\nexport * from './jupiterPerps';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,iDAA+B;AAC/B,4CAA0B;AAC1B,0CAAwB","sourcesContent":["export * from './action';\nexport * from './curve';\nexport * from './market';\nexport * from './obligation';\nexport * from './reserve';\nexport * from './shared';\nexport * from './utils';\nexport * from './jupiterPerps';\nexport * from './manager';\nexport * from './vault';\n"]}

package/dist/classes/manager.d.ts

@@ -0,0 +1,145 @@
+import { Connection, Keypair, PublicKey, TransactionInstruction } from '@solana/web3.js';
+import { KaminoVault, KaminoVaultClient, KaminoVaultConfig, ReserveAllocationConfig } from './vault';
+import { AddAssetToMarketParams, CreateKaminoMarketParams, ENV, MarketWithAddress, PubkeyHashMap, Reserve, ReserveWithAddress, ScopeOracleConfig } from '../lib';
+import { ReserveConfig } from '../idl_codegen/types';
+import Decimal from 'decimal.js';
+/**
+ * KaminoManager is a class that provides a high-level interface to interact with the Kamino Lend and Kamino Vault programs, in order to create and manage a market, as well as vaults
+ */
+export declare class KaminoManager {
+    private readonly _connection;
+    private readonly _kaminoVaultProgramId;
+    private readonly _kaminoLendProgramId;
+    private readonly _vaultClient;
+    recentSlotDurationMs: number;
+    constructor(connection: Connection, kaminoLendProgramId?: PublicKey, kaminoVaultProgramId?: PublicKey, recentSlotDurationMs?: number);
+    getConnection(): Connection;
+    getProgramID(): PublicKey;
+    /**
+     * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.
+     * @param params.admin - the admin of the market
+     * @returns market keypair - keypair used for market account creation -> to be signed with when executing the transaction
+     * @returns ixns - an array of ixns for creating and initializing the market account
+     */
+    createMarketIxs(params: CreateKaminoMarketParams): Promise<{
+        market: Keypair;
+        ixns: TransactionInstruction[];
+    }>;
+    /**
+     * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.
+     * @param params.admin - the admin of the reserve
+     * @param params.marketAddress - the market to create a reserve for, only the market admin can create a reserve for the market
+     * @param params.assetConfig - an object that helps generate a default reserve config with some inputs which have to be configured before calling this function
+     * @returns reserve - keypair used for reserve creation -> to be signed with when executing the transaction
+     * @returns txnIxns - an array of arrays of ixns -> first array for reserve creation, second for updating it with correct params
+     */
+    addAssetToMarketIxs(params: AddAssetToMarketParams): Promise<{
+        reserve: Keypair;
+        txnIxns: TransactionInstruction[][];
+    }>;
+    /**
+     * This method will create a vault with a given config. The config can be changed later on, but it is recommended to set it up correctly from the start
+     * @param vaultConfig - the config object used to create a vault
+     * @returns vault - keypair, should be used to sign the transaction which creates the vault account
+     * @returns ixns - an array of instructions to create the vault
+     */
+    createVaultIxs(vaultConfig: KaminoVaultConfig): Promise<{
+        vault: Keypair;
+        ixns: TransactionInstruction[];
+    }>;
+    /**
+     * This method updates the vault reserve allocation cofnig for an exiting vault reserve, or adds a new reserve to the vault if it does not exist.
+     * @param vault - vault to be updated
+     * @param reserveAllocationConfig - new reserve allocation config
+     * @returns - a list of instructions
+     */
+    updateVaultReserveAllocationIxs(vault: KaminoVault, reserveAllocationConfig: ReserveAllocationConfig): Promise<TransactionInstruction>;
+    /**
+     * This method retruns the reserve config for a given reserve
+     * @param reserve - reserve to get the config for
+     * @returns - the reserve config
+     */
+    getReserveConfig(reserve: PublicKey): Promise<ReserveConfig>;
+    /**
+     * This function enables the update of the scope oracle configuration. In order to get a list of scope prices, getScopeOracleConfigs can be used
+     * @param market - lending market which owns the reserve
+     * @param reserve - reserve which to be updated
+     * @param scopeOracleConfig - new scope oracle config
+     * @param scopeTwapConfig - new scope twap config
+     * @param maxAgeBufferSeconds - buffer to be added to onchain max_age - if oracle price is older than that, txns interacting with the reserve will fail
+     * @returns - an array of instructions used update the oracle configuration
+     */
+    updateReserveScopeOracleConfigurationIxs(market: MarketWithAddress, reserve: ReserveWithAddress, scopeOracleConfig: ScopeOracleConfig, scopeTwapConfig?: ScopeOracleConfig, maxAgeBufferSeconds?: number): Promise<TransactionInstruction[]>;
+    /**
+     * This function updates the given reserve with a new config. It can either update the entire reserve config or just update fields which differ between given reserve and existing reserve
+     * @param marketWithAddress - the market that owns the reserve to be updated
+     * @param reserve - the reserve to be updated
+     * @param config - the new reserve configuration to be used for the update
+     * @param reserveStateOverride - the reserve state, useful to provide, if already fetched outside this method, in order to avoid an extra rpc call to fetch it. Make sure the reserveConfig has not been updated since fetching the reserveState that you pass in.
+     * @param updateEntireConfig - when set to false, it will only update fields that are different between @param config and reserveState.config, set to true it will always update entire reserve config. An entire reserveConfig update might be too large for a multisig transaction
+     * @returns - an array of multiple update ixns. If there are many fields that are being updated without the updateEntireConfig=true, multiple transactions might be required to fit all ixns.
+     */
+    updateReserveIxs(marketWithAddress: MarketWithAddress, reserve: PublicKey, config: ReserveConfig, reserveStateOverride?: Reserve, updateEntireConfig?: boolean): Promise<TransactionInstruction[]>;
+    /**
+     * This function creates instructions to deposit into a vault. It will also create ATA creation instructions for the vault shares that the user receives in return
+     * @param user - user to deposit
+     * @param vault - vault to deposit into
+     * @param tokenAmount - token amount to be deposited, in decimals (will be converted in lamports)
+     * @returns - an array of instructions to be used to be executed
+     */
+    depositToVaultIxs(user: PublicKey, vault: KaminoVault, tokenAmount: Decimal): Promise<TransactionInstruction[]>;
+    /**
+     * This function will return the missing ATA creation instructions, as well as one or multiple withdraw instructions, based on how many reserves it's needed to withdraw from. This might have to be split in multiple transactions
+     * @param user - user to withdraw
+     * @param vault - vault to withdraw from
+     * @param shareAmount - share amount to withdraw, in order to withdraw everything, any value > user share amount
+     * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault
+     * @returns an array of instructions to be executed
+     */
+    withdrawFromVaultIxs(user: PublicKey, vault: KaminoVault, shareAmount: Decimal, slot: number): Promise<TransactionInstruction[]>;
+    /**
+     * This method calculates the token per share value. This will always change based on interest earned from the vault, but calculating it requires a bunch of rpc requests. Caching this for a short duration would be optimal
+     * @param vault - vault to calculate tokensPerShare for
+     * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault
+     * @returns - token per share value
+     */
+    getTokensPerShareSingleVault(vault: KaminoVault, slot: number): Promise<Decimal>;
+    /**
+     * This method returns the user shares balance for a given vault
+     * @param user - user to calculate the shares balance for
+     * @param vault - vault to calculate shares balance for
+     * @returns - user share balance in decimal (not lamports)
+     */
+    getUserSharesBalanceSingleVault(user: PublicKey, vault: KaminoVault): Promise<Decimal>;
+    /**
+     * This method returns the user shares balance for all existing vaults
+     * @param user - user to calculate the shares balance for
+     * @param vaultsOverride - the kamino vaults if already fetched, in order to reduce rpc calls
+     * @returns - hash map with keyh as vault address and value as user share balance in decimal (not lamports)
+     */
+    getUserSharesBalanceAllVaults(user: PublicKey, vaultsOverride: KaminoVault[]): Promise<PubkeyHashMap<PublicKey, Decimal>>;
+    /**
+     * @returns - the KaminoVault client
+     */
+    getKaminoVaultClient(): KaminoVaultClient;
+    /**
+     * This will trigger invest by balancing, based on weights, the reserve allocations of the vault. It can either withdraw or deposit into reserves to balance them. This is a function that should be cranked
+     * @param kaminoVault - vault to invest from
+     * @returns - an array of invest instructions for each invest action required for the vault reserves
+     */
+    investAllReserves(kaminoVault: KaminoVault): Promise<TransactionInstruction[]>;
+    /**
+     * This will trigger invest by balancing, based on weights, the reserve allocation of the vault. It can either withdraw or deposit into the given reserve to balance it
+     * @param kaminoVault - vault to invest from
+     * @param reserve - reserve to invest into or disinvest from
+     * @returns - an array of invest instructions for each invest action required for the vault reserves
+     */
+    investSingleReserve(kaminoVault: KaminoVault, reserveWithAddress: ReserveWithAddress): Promise<TransactionInstruction>;
+    /**
+     * This retruns an array of scope oracle configs to be used to set the scope price and twap oracles for a reserve
+     * @param feed - scope feed to fetch prices from
+     * @param cluster - cluster to fetch from, this should be left unchanged unless working on devnet or locally
+     * @returns - an array of scope oracle configs
+     */
+    getScopeOracleConfigs(feed?: string, cluster?: ENV): Promise<Array<ScopeOracleConfig>>;
+}

package/dist/classes/manager.js

@@ -0,0 +1,313 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KaminoManager = void 0;
+const web3_js_1 = require("@solana/web3.js");
+const vault_1 = require("./vault");
+const lib_1 = require("../lib");
+const programId_1 = require("../idl_codegen/programId");
+const scope_sdk_1 = require("@hubbleprotocol/scope-sdk");
+const bn_js_1 = __importDefault(require("bn.js"));
+const types_1 = require("../idl_codegen/types");
+/**
+ * KaminoManager is a class that provides a high-level interface to interact with the Kamino Lend and Kamino Vault programs, in order to create and manage a market, as well as vaults
+ */
+class KaminoManager {
+    constructor(connection, kaminoLendProgramId, kaminoVaultProgramId, recentSlotDurationMs) {
+        this._connection = connection;
+        this._kaminoVaultProgramId = kaminoVaultProgramId ? kaminoVaultProgramId : vault_1.kaminoVaultId;
+        this._kaminoLendProgramId = kaminoLendProgramId ? kaminoLendProgramId : programId_1.PROGRAM_ID;
+        this.recentSlotDurationMs = recentSlotDurationMs ? recentSlotDurationMs : lib_1.DEFAULT_RECENT_SLOT_DURATION_MS;
+        this._vaultClient = new vault_1.KaminoVaultClient(connection, this._kaminoVaultProgramId, this._kaminoLendProgramId, this.recentSlotDurationMs);
+    }
+    getConnection() {
+        return this._connection;
+    }
+    getProgramID() {
+        return this._kaminoVaultProgramId;
+    }
+    /**
+     * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.
+     * @param params.admin - the admin of the market
+     * @returns market keypair - keypair used for market account creation -> to be signed with when executing the transaction
+     * @returns ixns - an array of ixns for creating and initializing the market account
+     */
+    createMarketIxs(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const marketAccount = web3_js_1.Keypair.generate();
+            const size = lib_1.LendingMarket.layout.span + 8;
+            const [lendingMarketAuthority, _] = (0, lib_1.lendingMarketAuthPda)(marketAccount.publicKey, this._kaminoLendProgramId);
+            const createMarketIxns = [];
+            createMarketIxns.push(web3_js_1.SystemProgram.createAccount({
+                fromPubkey: params.admin,
+                newAccountPubkey: marketAccount.publicKey,
+                lamports: yield this._connection.getMinimumBalanceForRentExemption(size),
+                space: size,
+                programId: this._kaminoLendProgramId,
+            }));
+            const accounts = {
+                lendingMarketOwner: params.admin,
+                lendingMarket: marketAccount.publicKey,
+                lendingMarketAuthority: lendingMarketAuthority,
+                systemProgram: web3_js_1.SystemProgram.programId,
+                rent: web3_js_1.SYSVAR_RENT_PUBKEY,
+            };
+            const args = {
+                quoteCurrency: Array(32).fill(0),
+            };
+            createMarketIxns.push((0, lib_1.initLendingMarket)(args, accounts, this._kaminoLendProgramId));
+            return { market: marketAccount, ixns: createMarketIxns };
+        });
+    }
+    /**
+     * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.
+     * @param params.admin - the admin of the reserve
+     * @param params.marketAddress - the market to create a reserve for, only the market admin can create a reserve for the market
+     * @param params.assetConfig - an object that helps generate a default reserve config with some inputs which have to be configured before calling this function
+     * @returns reserve - keypair used for reserve creation -> to be signed with when executing the transaction
+     * @returns txnIxns - an array of arrays of ixns -> first array for reserve creation, second for updating it with correct params
+     */
+    addAssetToMarketIxs(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const market = yield lib_1.LendingMarket.fetch(this._connection, params.marketAddress, this._kaminoLendProgramId);
+            if (!market) {
+                throw new Error('Market not found');
+            }
+            const marketWithAddress = { address: params.marketAddress, state: market };
+            const reserveAccount = web3_js_1.Keypair.generate();
+            const createReserveInstructions = yield (0, lib_1.createReserveIxs)(this._connection, params.admin, params.marketAddress, params.assetConfig.mint, reserveAccount.publicKey, this._kaminoLendProgramId);
+            const updateReserveInstructions = yield this.updateReserveIxs(marketWithAddress, reserveAccount.publicKey, params.assetConfig.getReserveConfig(), undefined, true);
+            const txnIxns = [];
+            txnIxns.push(createReserveInstructions);
+            txnIxns.push(updateReserveInstructions);
+            return { reserve: reserveAccount, txnIxns };
+        });
+    }
+    /**
+     * This method will create a vault with a given config. The config can be changed later on, but it is recommended to set it up correctly from the start
+     * @param vaultConfig - the config object used to create a vault
+     * @returns vault - keypair, should be used to sign the transaction which creates the vault account
+     * @returns ixns - an array of instructions to create the vault
+     */
+    createVaultIxs(vaultConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.createVaultIxs(vaultConfig);
+        });
+    }
+    /**
+     * This method updates the vault reserve allocation cofnig for an exiting vault reserve, or adds a new reserve to the vault if it does not exist.
+     * @param vault - vault to be updated
+     * @param reserveAllocationConfig - new reserve allocation config
+     * @returns - a list of instructions
+     */
+    updateVaultReserveAllocationIxs(vault, reserveAllocationConfig) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.updateReserveAllocationIxs(vault, reserveAllocationConfig);
+        });
+    }
+    /**
+     * This method retruns the reserve config for a given reserve
+     * @param reserve - reserve to get the config for
+     * @returns - the reserve config
+     */
+    getReserveConfig(reserve) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const reserveState = yield lib_1.Reserve.fetch(this._connection, reserve);
+            if (!reserveState) {
+                throw new Error('Reserve not found');
+            }
+            return reserveState.config;
+        });
+    }
+    /**
+     * This function enables the update of the scope oracle configuration. In order to get a list of scope prices, getScopeOracleConfigs can be used
+     * @param market - lending market which owns the reserve
+     * @param reserve - reserve which to be updated
+     * @param scopeOracleConfig - new scope oracle config
+     * @param scopeTwapConfig - new scope twap config
+     * @param maxAgeBufferSeconds - buffer to be added to onchain max_age - if oracle price is older than that, txns interacting with the reserve will fail
+     * @returns - an array of instructions used update the oracle configuration
+     */
+    updateReserveScopeOracleConfigurationIxs(market_1, reserve_1, scopeOracleConfig_1, scopeTwapConfig_1) {
+        return __awaiter(this, arguments, void 0, function* (market, reserve, scopeOracleConfig, scopeTwapConfig, maxAgeBufferSeconds = 20) {
+            const reserveConfig = reserve.state.config;
+            let scopeTwapId = scope_sdk_1.U16_MAX;
+            if (scopeTwapConfig) {
+                scopeTwapId = scopeTwapConfig.oracleId;
+                // if(scopeTwapConfig.twapSourceId !== scopeOracleConfig.oracleId) {
+                //   throw new Error('Twap source id must match oracle id');
+                // }
+            }
+            const { scopeConfiguration } = (0, lib_1.getReserveOracleConfigs)({
+                scopePriceConfigAddress: scopeOracleConfig.scopePriceConfigAddress,
+                scopeChain: [scopeOracleConfig.oracleId],
+                scopeTwapChain: [scopeTwapId],
+            });
+            const newReserveConfig = new types_1.ReserveConfig(Object.assign(Object.assign({}, reserveConfig), { tokenInfo: Object.assign(Object.assign({}, reserveConfig.tokenInfo), { scopeConfiguration: scopeConfiguration, 
+                    // TODO: Decide if we want to keep this maxAge override for twap & price
+                    maxAgeTwapSeconds: scopeTwapConfig
+                        ? new bn_js_1.default(scopeTwapConfig.max_age + maxAgeBufferSeconds)
+                        : reserveConfig.tokenInfo.maxAgeTwapSeconds, maxAgePriceSeconds: new bn_js_1.default(scopeOracleConfig.max_age + maxAgeBufferSeconds) }) }));
+            return this.updateReserveIxs(market, reserve.address, newReserveConfig, reserve.state);
+        });
+    }
+    /**
+     * This function updates the given reserve with a new config. It can either update the entire reserve config or just update fields which differ between given reserve and existing reserve
+     * @param marketWithAddress - the market that owns the reserve to be updated
+     * @param reserve - the reserve to be updated
+     * @param config - the new reserve configuration to be used for the update
+     * @param reserveStateOverride - the reserve state, useful to provide, if already fetched outside this method, in order to avoid an extra rpc call to fetch it. Make sure the reserveConfig has not been updated since fetching the reserveState that you pass in.
+     * @param updateEntireConfig - when set to false, it will only update fields that are different between @param config and reserveState.config, set to true it will always update entire reserve config. An entire reserveConfig update might be too large for a multisig transaction
+     * @returns - an array of multiple update ixns. If there are many fields that are being updated without the updateEntireConfig=true, multiple transactions might be required to fit all ixns.
+     */
+    updateReserveIxs(marketWithAddress_1, reserve_1, config_1, reserveStateOverride_1) {
+        return __awaiter(this, arguments, void 0, function* (marketWithAddress, reserve, config, reserveStateOverride, updateEntireConfig = false) {
+            const reserveState = reserveStateOverride
+                ? reserveStateOverride
+                : (yield lib_1.Reserve.fetch(this._connection, reserve, this._kaminoLendProgramId));
+            const ixns = [];
+            if (!reserveState || updateEntireConfig) {
+                ixns.push((0, lib_1.updateEntireReserveConfigIx)(marketWithAddress, reserve, config, this._kaminoLendProgramId));
+            }
+            else {
+                ixns.push(...(0, lib_1.parseForChangesReserveConfigAndGetIxs)(marketWithAddress, reserveState, reserve, config, this._kaminoLendProgramId));
+            }
+            return ixns;
+        });
+    }
+    /**
+     * This function creates instructions to deposit into a vault. It will also create ATA creation instructions for the vault shares that the user receives in return
+     * @param user - user to deposit
+     * @param vault - vault to deposit into
+     * @param tokenAmount - token amount to be deposited, in decimals (will be converted in lamports)
+     * @returns - an array of instructions to be used to be executed
+     */
+    depositToVaultIxs(user, vault, tokenAmount) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.depositIxs(user, vault, tokenAmount);
+        });
+    }
+    /**
+     * This function will return the missing ATA creation instructions, as well as one or multiple withdraw instructions, based on how many reserves it's needed to withdraw from. This might have to be split in multiple transactions
+     * @param user - user to withdraw
+     * @param vault - vault to withdraw from
+     * @param shareAmount - share amount to withdraw, in order to withdraw everything, any value > user share amount
+     * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault
+     * @returns an array of instructions to be executed
+     */
+    withdrawFromVaultIxs(user, vault, shareAmount, slot) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.withdrawIxs(user, vault, shareAmount, slot);
+        });
+    }
+    /**
+     * This method calculates the token per share value. This will always change based on interest earned from the vault, but calculating it requires a bunch of rpc requests. Caching this for a short duration would be optimal
+     * @param vault - vault to calculate tokensPerShare for
+     * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault
+     * @returns - token per share value
+     */
+    getTokensPerShareSingleVault(vault, slot) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.getTokensPerShareSingleVault(vault, slot);
+        });
+    }
+    /**
+     * This method returns the user shares balance for a given vault
+     * @param user - user to calculate the shares balance for
+     * @param vault - vault to calculate shares balance for
+     * @returns - user share balance in decimal (not lamports)
+     */
+    getUserSharesBalanceSingleVault(user, vault) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.getUserSharesBalanceSingleVault(user, vault);
+        });
+    }
+    /**
+     * This method returns the user shares balance for all existing vaults
+     * @param user - user to calculate the shares balance for
+     * @param vaultsOverride - the kamino vaults if already fetched, in order to reduce rpc calls
+     * @returns - hash map with keyh as vault address and value as user share balance in decimal (not lamports)
+     */
+    getUserSharesBalanceAllVaults(user, vaultsOverride) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.getUserSharesBalanceAllVaults(user, vaultsOverride);
+        });
+    }
+    /**
+     * @returns - the KaminoVault client
+     */
+    getKaminoVaultClient() {
+        return this._vaultClient;
+    }
+    /**
+     * This will trigger invest by balancing, based on weights, the reserve allocations of the vault. It can either withdraw or deposit into reserves to balance them. This is a function that should be cranked
+     * @param kaminoVault - vault to invest from
+     * @returns - an array of invest instructions for each invest action required for the vault reserves
+     */
+    investAllReserves(kaminoVault) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.investAllReservesIxs(kaminoVault);
+        });
+    }
+    /**
+     * This will trigger invest by balancing, based on weights, the reserve allocation of the vault. It can either withdraw or deposit into the given reserve to balance it
+     * @param kaminoVault - vault to invest from
+     * @param reserve - reserve to invest into or disinvest from
+     * @returns - an array of invest instructions for each invest action required for the vault reserves
+     */
+    investSingleReserve(kaminoVault, reserveWithAddress) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._vaultClient.investSingleReserveIxs(kaminoVault, reserveWithAddress);
+        });
+    }
+    /**
+     * This retruns an array of scope oracle configs to be used to set the scope price and twap oracles for a reserve
+     * @param feed - scope feed to fetch prices from
+     * @param cluster - cluster to fetch from, this should be left unchanged unless working on devnet or locally
+     * @returns - an array of scope oracle configs
+     */
+    getScopeOracleConfigs() {
+        return __awaiter(this, arguments, void 0, function* (feed = 'hubble', cluster = 'mainnet-beta') {
+            const scopeOracleConfigs = [];
+            const scope = new scope_sdk_1.Scope(cluster, this._connection);
+            const oracleMappings = yield scope.getOracleMappings({ feed: feed });
+            const [, feedConfig] = yield scope.getFeedConfiguration({ feed: feed });
+            const tokenMetadatas = yield scope_sdk_1.TokenMetadatas.fetch(this._connection, feedConfig.tokensMetadata);
+            const decoder = new TextDecoder('utf-8');
+            console.log('feedConfig.tokensMetadata', feedConfig.tokensMetadata);
+            if (tokenMetadatas === null) {
+                throw new Error('TokenMetadatas not found');
+            }
+            for (let index = 0; index < oracleMappings.priceInfoAccounts.length; index++) {
+                if (!oracleMappings.priceInfoAccounts[index].equals(web3_js_1.PublicKey.default)) {
+                    const name = decoder.decode(Uint8Array.from(tokenMetadatas.metadatasArray[index].name)).replace(/\0/g, '');
+                    const oracleType = (0, lib_1.parseOracleType)(oracleMappings.priceTypes[index]);
+                    scopeOracleConfigs.push({
+                        scopePriceConfigAddress: feedConfig.oraclePrices,
+                        name: name,
+                        oracleType: oracleType,
+                        oracleId: index,
+                        oracleAccount: oracleMappings.priceInfoAccounts[index],
+                        twapEnabled: oracleMappings.twapEnabled[index] === 1,
+                        twapSourceId: oracleMappings.twapSource[index],
+                        max_age: tokenMetadatas.metadatasArray[index].maxAgePriceSlots.toNumber(),
+                    });
+                }
+            }
+            return scopeOracleConfigs;
+        });
+    }
+} // KaminoManager
+exports.KaminoManager = KaminoManager;
+//# sourceMappingURL=manager.js.map

package/dist/classes/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/classes/manager.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Connection,\n  Keypair,\n  PublicKey,\n  SystemProgram,\n  SYSVAR_RENT_PUBKEY,\n  TransactionInstruction,\n} from '@solana/web3.js';\nimport { KaminoVault, KaminoVaultClient, KaminoVaultConfig, kaminoVaultId, ReserveAllocationConfig } from './vault';\nimport {\n  AddAssetToMarketParams,\n  CreateKaminoMarketParams,\n  createReserveIxs,\n  DEFAULT_RECENT_SLOT_DURATION_MS,\n  ENV,\n  getReserveOracleConfigs,\n  initLendingMarket,\n  InitLendingMarketAccounts,\n  InitLendingMarketArgs,\n  LendingMarket,\n  lendingMarketAuthPda,\n  MarketWithAddress,\n  parseForChangesReserveConfigAndGetIxs,\n  parseOracleType,\n  PubkeyHashMap,\n  Reserve,\n  ReserveWithAddress,\n  ScopeOracleConfig,\n  updateEntireReserveConfigIx,\n} from '../lib';\nimport { PROGRAM_ID } from '../idl_codegen/programId';\nimport { Scope, TokenMetadatas, U16_MAX } from '@hubbleprotocol/scope-sdk';\nimport BN from 'bn.js';\nimport { ReserveConfig } from '../idl_codegen/types';\nimport Decimal from 'decimal.js';\n\n/**\n * KaminoManager is a class that provides a high-level interface to interact with the Kamino Lend and Kamino Vault programs, in order to create and manage a market, as well as vaults\n */\nexport class KaminoManager {\n  private readonly _connection: Connection;\n  private readonly _kaminoVaultProgramId: PublicKey;\n  private readonly _kaminoLendProgramId: PublicKey;\n  private readonly _vaultClient: KaminoVaultClient;\n  recentSlotDurationMs: number;\n\n  constructor(\n    connection: Connection,\n    kaminoLendProgramId?: PublicKey,\n    kaminoVaultProgramId?: PublicKey,\n    recentSlotDurationMs?: number\n  ) {\n    this._connection = connection;\n    this._kaminoVaultProgramId = kaminoVaultProgramId ? kaminoVaultProgramId : kaminoVaultId;\n    this._kaminoLendProgramId = kaminoLendProgramId ? kaminoLendProgramId : PROGRAM_ID;\n    this.recentSlotDurationMs = recentSlotDurationMs ? recentSlotDurationMs : DEFAULT_RECENT_SLOT_DURATION_MS;\n    this._vaultClient = new KaminoVaultClient(\n      connection,\n      this._kaminoVaultProgramId,\n      this._kaminoLendProgramId,\n      this.recentSlotDurationMs\n    );\n  }\n\n  getConnection() {\n    return this._connection;\n  }\n\n  getProgramID() {\n    return this._kaminoVaultProgramId;\n  }\n\n  /**\n   * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.\n   * @param params.admin - the admin of the market\n   * @returns market keypair - keypair used for market account creation -> to be signed with when executing the transaction\n   * @returns ixns - an array of ixns for creating and initializing the market account\n   */\n  async createMarketIxs(\n    params: CreateKaminoMarketParams\n  ): Promise<{ market: Keypair; ixns: TransactionInstruction[] }> {\n    const marketAccount = Keypair.generate();\n    const size = LendingMarket.layout.span + 8;\n    const [lendingMarketAuthority, _] = lendingMarketAuthPda(marketAccount.publicKey, this._kaminoLendProgramId);\n    const createMarketIxns: TransactionInstruction[] = [];\n\n    createMarketIxns.push(\n      SystemProgram.createAccount({\n        fromPubkey: params.admin,\n        newAccountPubkey: marketAccount.publicKey,\n        lamports: await this._connection.getMinimumBalanceForRentExemption(size),\n        space: size,\n        programId: this._kaminoLendProgramId,\n      })\n    );\n\n    const accounts: InitLendingMarketAccounts = {\n      lendingMarketOwner: params.admin,\n      lendingMarket: marketAccount.publicKey,\n      lendingMarketAuthority: lendingMarketAuthority,\n      systemProgram: SystemProgram.programId,\n      rent: SYSVAR_RENT_PUBKEY,\n    };\n\n    const args: InitLendingMarketArgs = {\n      quoteCurrency: Array(32).fill(0),\n    };\n\n    createMarketIxns.push(initLendingMarket(args, accounts, this._kaminoLendProgramId));\n\n    return { market: marketAccount, ixns: createMarketIxns };\n  }\n\n  /**\n   * This is a function that helps quickly setting up a reserve for an asset with a default config. The config can be modified later on.\n   * @param params.admin - the admin of the reserve\n   * @param params.marketAddress - the market to create a reserve for, only the market admin can create a reserve for the market\n   * @param params.assetConfig - an object that helps generate a default reserve config with some inputs which have to be configured before calling this function\n   * @returns reserve - keypair used for reserve creation -> to be signed with when executing the transaction\n   * @returns txnIxns - an array of arrays of ixns -> first array for reserve creation, second for updating it with correct params\n   */\n  async addAssetToMarketIxs(\n    params: AddAssetToMarketParams\n  ): Promise<{ reserve: Keypair; txnIxns: TransactionInstruction[][] }> {\n    const market = await LendingMarket.fetch(this._connection, params.marketAddress, this._kaminoLendProgramId);\n    if (!market) {\n      throw new Error('Market not found');\n    }\n    const marketWithAddress: MarketWithAddress = { address: params.marketAddress, state: market };\n\n    const reserveAccount = Keypair.generate();\n\n    const createReserveInstructions = await createReserveIxs(\n      this._connection,\n      params.admin,\n      params.marketAddress,\n      params.assetConfig.mint,\n      reserveAccount.publicKey,\n      this._kaminoLendProgramId\n    );\n\n    const updateReserveInstructions = await this.updateReserveIxs(\n      marketWithAddress,\n      reserveAccount.publicKey,\n      params.assetConfig.getReserveConfig(),\n      undefined,\n      true\n    );\n\n    const txnIxns: TransactionInstruction[][] = [];\n    txnIxns.push(createReserveInstructions);\n    txnIxns.push(updateReserveInstructions);\n\n    return { reserve: reserveAccount, txnIxns };\n  }\n\n  /**\n   * This method will create a vault with a given config. The config can be changed later on, but it is recommended to set it up correctly from the start\n   * @param vaultConfig - the config object used to create a vault\n   * @returns vault - keypair, should be used to sign the transaction which creates the vault account\n   * @returns ixns - an array of instructions to create the vault\n   */\n  async createVaultIxs(vaultConfig: KaminoVaultConfig): Promise<{ vault: Keypair; ixns: TransactionInstruction[] }> {\n    return this._vaultClient.createVaultIxs(vaultConfig);\n  }\n\n  /**\n   * This method updates the vault reserve allocation cofnig for an exiting vault reserve, or adds a new reserve to the vault if it does not exist.\n   * @param vault - vault to be updated\n   * @param reserveAllocationConfig - new reserve allocation config\n   * @returns - a list of instructions\n   */\n  async updateVaultReserveAllocationIxs(\n    vault: KaminoVault,\n    reserveAllocationConfig: ReserveAllocationConfig\n  ): Promise<TransactionInstruction> {\n    return this._vaultClient.updateReserveAllocationIxs(vault, reserveAllocationConfig);\n  }\n\n  /**\n   * This method retruns the reserve config for a given reserve\n   * @param reserve - reserve to get the config for\n   * @returns - the reserve config\n   */\n  async getReserveConfig(reserve: PublicKey): Promise<ReserveConfig> {\n    const reserveState = await Reserve.fetch(this._connection, reserve);\n    if (!reserveState) {\n      throw new Error('Reserve not found');\n    }\n    return reserveState.config;\n  }\n\n  /**\n   * This function enables the update of the scope oracle configuration. In order to get a list of scope prices, getScopeOracleConfigs can be used\n   * @param market - lending market which owns the reserve\n   * @param reserve - reserve which to be updated\n   * @param scopeOracleConfig - new scope oracle config\n   * @param scopeTwapConfig - new scope twap config\n   * @param maxAgeBufferSeconds - buffer to be added to onchain max_age - if oracle price is older than that, txns interacting with the reserve will fail\n   * @returns - an array of instructions used update the oracle configuration\n   */\n  async updateReserveScopeOracleConfigurationIxs(\n    market: MarketWithAddress,\n    reserve: ReserveWithAddress,\n    scopeOracleConfig: ScopeOracleConfig,\n    scopeTwapConfig?: ScopeOracleConfig,\n    maxAgeBufferSeconds: number = 20\n  ): Promise<TransactionInstruction[]> {\n    const reserveConfig = reserve.state.config;\n\n    let scopeTwapId = U16_MAX;\n    if (scopeTwapConfig) {\n      scopeTwapId = scopeTwapConfig.oracleId;\n\n      // if(scopeTwapConfig.twapSourceId !== scopeOracleConfig.oracleId) {\n      //   throw new Error('Twap source id must match oracle id');\n      // }\n    }\n\n    const { scopeConfiguration } = getReserveOracleConfigs({\n      scopePriceConfigAddress: scopeOracleConfig.scopePriceConfigAddress,\n      scopeChain: [scopeOracleConfig.oracleId],\n      scopeTwapChain: [scopeTwapId],\n    });\n\n    const newReserveConfig = new ReserveConfig({\n      ...reserveConfig,\n      tokenInfo: {\n        ...reserveConfig.tokenInfo,\n        scopeConfiguration: scopeConfiguration,\n        // TODO: Decide if we want to keep this maxAge override for twap & price\n        maxAgeTwapSeconds: scopeTwapConfig\n          ? new BN(scopeTwapConfig.max_age + maxAgeBufferSeconds)\n          : reserveConfig.tokenInfo.maxAgeTwapSeconds,\n        maxAgePriceSeconds: new BN(scopeOracleConfig.max_age + maxAgeBufferSeconds),\n      },\n    });\n\n    return this.updateReserveIxs(market, reserve.address, newReserveConfig, reserve.state);\n  }\n\n  /**\n   * This function updates the given reserve with a new config. It can either update the entire reserve config or just update fields which differ between given reserve and existing reserve\n   * @param marketWithAddress - the market that owns the reserve to be updated\n   * @param reserve - the reserve to be updated\n   * @param config - the new reserve configuration to be used for the update\n   * @param reserveStateOverride - the reserve state, useful to provide, if already fetched outside this method, in order to avoid an extra rpc call to fetch it. Make sure the reserveConfig has not been updated since fetching the reserveState that you pass in.\n   * @param updateEntireConfig - when set to false, it will only update fields that are different between @param config and reserveState.config, set to true it will always update entire reserve config. An entire reserveConfig update might be too large for a multisig transaction\n   * @returns - an array of multiple update ixns. If there are many fields that are being updated without the updateEntireConfig=true, multiple transactions might be required to fit all ixns.\n   */\n  async updateReserveIxs(\n    marketWithAddress: MarketWithAddress,\n    reserve: PublicKey,\n    config: ReserveConfig,\n    reserveStateOverride?: Reserve,\n    updateEntireConfig: boolean = false\n  ): Promise<TransactionInstruction[]> {\n    const reserveState = reserveStateOverride\n      ? reserveStateOverride\n      : (await Reserve.fetch(this._connection, reserve, this._kaminoLendProgramId))!;\n    const ixns: TransactionInstruction[] = [];\n\n    if (!reserveState || updateEntireConfig) {\n      ixns.push(updateEntireReserveConfigIx(marketWithAddress, reserve, config, this._kaminoLendProgramId));\n    } else {\n      ixns.push(\n        ...parseForChangesReserveConfigAndGetIxs(\n          marketWithAddress,\n          reserveState,\n          reserve,\n          config,\n          this._kaminoLendProgramId\n        )\n      );\n    }\n\n    return ixns;\n  }\n\n  /**\n   * This function creates instructions to deposit into a vault. It will also create ATA creation instructions for the vault shares that the user receives in return\n   * @param user - user to deposit\n   * @param vault - vault to deposit into\n   * @param tokenAmount - token amount to be deposited, in decimals (will be converted in lamports)\n   * @returns - an array of instructions to be used to be executed\n   */\n  async depositToVaultIxs(\n    user: PublicKey,\n    vault: KaminoVault,\n    tokenAmount: Decimal\n  ): Promise<TransactionInstruction[]> {\n    return this._vaultClient.depositIxs(user, vault, tokenAmount);\n  }\n\n  /**\n   * This function will return the missing ATA creation instructions, as well as one or multiple withdraw instructions, based on how many reserves it's needed to withdraw from. This might have to be split in multiple transactions\n   * @param user - user to withdraw\n   * @param vault - vault to withdraw from\n   * @param shareAmount - share amount to withdraw, in order to withdraw everything, any value > user share amount\n   * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault\n   * @returns an array of instructions to be executed\n   */\n  async withdrawFromVaultIxs(\n    user: PublicKey,\n    vault: KaminoVault,\n    shareAmount: Decimal,\n    slot: number\n  ): Promise<TransactionInstruction[]> {\n    return this._vaultClient.withdrawIxs(user, vault, shareAmount, slot);\n  }\n\n  /**\n   * This method calculates the token per share value. This will always change based on interest earned from the vault, but calculating it requires a bunch of rpc requests. Caching this for a short duration would be optimal\n   * @param vault - vault to calculate tokensPerShare for\n   * @param slot - current slot, used to estimate the interest earned in the different reserves with allocation from the vault\n   * @returns - token per share value\n   */\n  async getTokensPerShareSingleVault(vault: KaminoVault, slot: number): Promise<Decimal> {\n    return this._vaultClient.getTokensPerShareSingleVault(vault, slot);\n  }\n\n  /**\n   * This method returns the user shares balance for a given vault\n   * @param user - user to calculate the shares balance for\n   * @param vault - vault to calculate shares balance for\n   * @returns - user share balance in decimal (not lamports)\n   */\n  async getUserSharesBalanceSingleVault(user: PublicKey, vault: KaminoVault): Promise<Decimal> {\n    return this._vaultClient.getUserSharesBalanceSingleVault(user, vault);\n  }\n\n  /**\n   * This method returns the user shares balance for all existing vaults\n   * @param user - user to calculate the shares balance for\n   * @param vaultsOverride - the kamino vaults if already fetched, in order to reduce rpc calls\n   * @returns - hash map with keyh as vault address and value as user share balance in decimal (not lamports)\n   */\n  async getUserSharesBalanceAllVaults(\n    user: PublicKey,\n    vaultsOverride: KaminoVault[]\n  ): Promise<PubkeyHashMap<PublicKey, Decimal>> {\n    return this._vaultClient.getUserSharesBalanceAllVaults(user, vaultsOverride);\n  }\n\n  /**\n   * @returns - the KaminoVault client\n   */\n  getKaminoVaultClient(): KaminoVaultClient {\n    return this._vaultClient;\n  }\n\n  /**\n   * This will trigger invest by balancing, based on weights, the reserve allocations of the vault. It can either withdraw or deposit into reserves to balance them. This is a function that should be cranked\n   * @param kaminoVault - vault to invest from\n   * @returns - an array of invest instructions for each invest action required for the vault reserves\n   */\n  async investAllReserves(kaminoVault: KaminoVault): Promise<TransactionInstruction[]> {\n    return this._vaultClient.investAllReservesIxs(kaminoVault);\n  }\n\n  /**\n   * This will trigger invest by balancing, based on weights, the reserve allocation of the vault. It can either withdraw or deposit into the given reserve to balance it\n   * @param kaminoVault - vault to invest from\n   * @param reserve - reserve to invest into or disinvest from\n   * @returns - an array of invest instructions for each invest action required for the vault reserves\n   */\n  async investSingleReserve(\n    kaminoVault: KaminoVault,\n    reserveWithAddress: ReserveWithAddress\n  ): Promise<TransactionInstruction> {\n    return this._vaultClient.investSingleReserveIxs(kaminoVault, reserveWithAddress);\n  }\n\n  /**\n   * This retruns an array of scope oracle configs to be used to set the scope price and twap oracles for a reserve\n   * @param feed - scope feed to fetch prices from\n   * @param cluster - cluster to fetch from, this should be left unchanged unless working on devnet or locally\n   * @returns - an array of scope oracle configs\n   */\n  async getScopeOracleConfigs(\n    feed: string = 'hubble',\n    cluster: ENV = 'mainnet-beta'\n  ): Promise<Array<ScopeOracleConfig>> {\n    const scopeOracleConfigs: Array<ScopeOracleConfig> = [];\n\n    const scope = new Scope(cluster, this._connection);\n    const oracleMappings = await scope.getOracleMappings({ feed: feed });\n    const [, feedConfig] = await scope.getFeedConfiguration({ feed: feed });\n    const tokenMetadatas = await TokenMetadatas.fetch(this._connection, feedConfig.tokensMetadata);\n    const decoder = new TextDecoder('utf-8');\n\n    console.log('feedConfig.tokensMetadata', feedConfig.tokensMetadata);\n\n    if (tokenMetadatas === null) {\n      throw new Error('TokenMetadatas not found');\n    }\n\n    for (let index = 0; index < oracleMappings.priceInfoAccounts.length; index++) {\n      if (!oracleMappings.priceInfoAccounts[index].equals(PublicKey.default)) {\n        const name = decoder.decode(Uint8Array.from(tokenMetadatas.metadatasArray[index].name)).replace(/\\0/g, '');\n        const oracleType = parseOracleType(oracleMappings.priceTypes[index]);\n\n        scopeOracleConfigs.push({\n          scopePriceConfigAddress: feedConfig.oraclePrices,\n          name: name,\n          oracleType: oracleType,\n          oracleId: index,\n          oracleAccount: oracleMappings.priceInfoAccounts[index],\n          twapEnabled: oracleMappings.twapEnabled[index] === 1,\n          twapSourceId: oracleMappings.twapSource[index],\n          max_age: tokenMetadatas.metadatasArray[index].maxAgePriceSlots.toNumber(),\n        });\n      }\n    }\n\n    return scopeOracleConfigs;\n  }\n} // KaminoManager\n"]}

package/dist/classes/reserve.d.ts

@@ -1,8 +1,9 @@
-import { AccountInfo, Connection, PublicKey } from '@solana/web3.js';
+import { AccountInfo, Connection, PublicKey, TransactionInstruction } from '@solana/web3.js';
 import Decimal from 'decimal.js';
-import { TokenOracleData } from '../utils';
+import { MarketWithAddress, TokenOracleData } from '../utils';
 import { ReserveDataType } from './shared';
 import { Reserve } from '../idl_codegen/accounts';
+import { BorrowRateCurve, ReserveConfig } from '../idl_codegen/types';
 import { ActionType } from './action';
 import { KaminoMarket } from './market';
 export declare const DEFAULT_RECENT_SLOT_DURATION_MS = 450;
@@ -215,3 +216,13 @@ export declare class KaminoReserve {
      */
     private approximateCompoundedInterest;
 }
+export declare function createReserveIxs(connection: Connection, owner: PublicKey, lendingMarket: PublicKey, liquidityMint: PublicKey, reserveAddress: PublicKey, programId: PublicKey): Promise<TransactionInstruction[]>;
+export declare function updateReserveConfigIx(marketWithAddress: MarketWithAddress, reserveAddress: PublicKey, modeDiscriminator: number, value: Uint8Array, programId: PublicKey): TransactionInstruction;
+export declare function updateEntireReserveConfigIx(marketWithAddress: MarketWithAddress, reserveAddress: PublicKey, reserveConfig: ReserveConfig, programId: PublicKey): TransactionInstruction;
+export declare function parseForChangesReserveConfigAndGetIxs(marketWithAddress: MarketWithAddress, reserve: Reserve | undefined, reserveAddress: PublicKey, reserveConfig: ReserveConfig, programId: PublicKey): TransactionInstruction[];
+export declare function updateReserveConfigEncodedValue(discriminator: number, value: number | number[] | BorrowRateCurve | PublicKey): Uint8Array;
+export declare function serializeBorrowRateCurve(curve: BorrowRateCurve): Buffer;
+export type ReserveWithAddress = {
+    address: PublicKey;
+    state: Reserve;
+};