@kestrelfi/lyc-sdk 1.0.1

package/dist/shared/lending-platforms/src/data/incentive/kamino.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KaminoIncentiveData = void 0;
+const decimal_js_1 = __importDefault(require("decimal.js"));
+const core_1 = require("@anchor-lang/core");
+const incentiveBase_1 = require("./incentiveBase");
+const farms_sdk_1 = require("@kamino-finance/farms-sdk");
+const common_1 = require("common");
+const utils_1 = require("../../utils");
+/**
+ * Kamino-specific incentive data for farm rewards.
+ * Handles both collateral farms (reward lenders) and debt farms (reward borrowers),
+ * as well as paired incentives that require specific collateral/debt combinations.
+ */
+class KaminoIncentiveData extends incentiveBase_1.TokenIncentiveBase {
+    /**
+     * Creates a KaminoIncentiveData instance from farm and reserve data.
+     * Determines the incentive type and calculates current exchange rates.
+     */
+    static loadData(args, reserve, prices, slot) {
+        const { data: { key, farmState }, rewardIndex, requiresPairReserve, isDebtFarm, } = args;
+        const rewardInfo = farmState.rewardInfos[rewardIndex];
+        const data = new KaminoIncentiveData(key, {
+            rewardMint: rewardInfo.token.mint,
+            incentiveType: isDebtFarm
+                ? incentiveBase_1.IncentiveType.BorrowingOnly
+                : requiresPairReserve
+                    ? incentiveBase_1.IncentiveType.Pair
+                    : incentiveBase_1.IncentiveType.LendingOnly,
+            requiresPairReserve,
+        });
+        data.rawReserve = reserve;
+        data.rawFarm = farmState;
+        data.rewardInfo = farmState.rewardInfos[rewardIndex];
+        data.isDebtFarm = isDebtFarm;
+        const collateralExchangeRate = reserve.getEstimatedCollateralExchangeRate(slot, 0).toNumber();
+        const debtExchangeRate = reserve.getEstimatedCumulativeBorrowRate(slot, 0).toNumber();
+        data.exchangeRate = isDebtFarm ? debtExchangeRate : collateralExchangeRate;
+        const rewardMint = rewardInfo.token.mint;
+        const scope = prices.scope.spot[rewardMint];
+        const pyth = prices.pyth.spot[rewardMint];
+        const swb = prices.switchboard.spot[rewardMint];
+        // TODO: need to fetch the price if kamino doesn't provide it
+        data.rewardMintPrice = scope
+            ? scope.price.toNumber()
+            : pyth
+                ? pyth.price.toNumber()
+                : swb
+                    ? swb.price.toNumber()
+                    : 0;
+        return data;
+    }
+    /**
+     * Checks if the incentive is currently active.
+     * An incentive is active if rewards are available, the schedule has started,
+     * and there is a non-zero emission rate.
+     */
+    active() {
+        const rewardsAvailable = this.rewardInfo.rewardsAvailable.gtn(0);
+        const hasStarted = this.rewardInfo.rewardScheduleCurve.points[0].tsStart.toNumber() < (0, common_1.currentUnixSeconds)();
+        const rewardPerTokenPerSecond = (0, farms_sdk_1.calculateCurrentRewardPerToken)(this.rewardInfo, new decimal_js_1.default((0, common_1.currentUnixSeconds)()));
+        return rewardsAvailable && hasStarted && rewardPerTokenPerSecond > 0;
+    }
+    /** Calculates the current APY based on total staked amount and reward emission rate */
+    apy() {
+        const { totalStaked, stakedTokenDecimals } = this.getStakedTokenData();
+        return (0, utils_1.calculateRewardAPY)(this.rawReserve.getLiquidityMint(), this.rewardInfo, totalStaked.toString(), stakedTokenDecimals, this.exchangeRate, this.rewardMintPrice, Boolean(this.config.requiresPairReserve));
+    }
+    /**
+     * Simulates the APY after a hypothetical position change.
+     * Useful for calculating expected rewards before executing a transaction.
+     */
+    simulateNewAPY(args) {
+        const changeInUnderlying = this.isDebtFarm
+            ? (args.debtChange ?? 0)
+            : (args.collateralChange ?? 0);
+        if (changeInUnderlying === 0) {
+            return this.apy();
+        }
+        const { totalStaked, stakedTokenDecimals } = this.getStakedTokenData();
+        const changeInShares = changeInUnderlying / this.exchangeRate;
+        const changeInSharesRaw = new core_1.BN(Math.round(changeInShares * Math.pow(10, stakedTokenDecimals)));
+        const newTotalStakedRaw = new core_1.BN(totalStaked.toString()).add(changeInSharesRaw);
+        return (0, utils_1.calculateRewardAPY)(this.rawReserve.getLiquidityMint(), this.rewardInfo, newTotalStakedRaw.toString(), stakedTokenDecimals, this.exchangeRate, this.rewardMintPrice, Boolean(this.config.requiresPairReserve));
+    }
+    /**
+     * Returns staking metrics for APY calculation.
+     * Falls back to reserve decimals if farm token decimals are not set.
+     */
+    getStakedTokenData() {
+        return {
+            totalStaked: this.rawFarm.totalStakedAmount,
+            stakedTokenDecimals: this.rawFarm.token.decimals.toNumber() ||
+                (this.config.requiresPairReserve ? 6 : this.rawReserve.getMintDecimals()),
+        };
+    }
+}
+exports.KaminoIncentiveData = KaminoIncentiveData;

package/dist/shared/lending-platforms/src/data/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./platform";
+export * from "./reserve";
+export * from "./userPosition";
+export * from "./incentive";
+export * from "./instructions";
+export * from "./accounts";

package/dist/shared/lending-platforms/src/data/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./platform"), exports);
+__exportStar(require("./reserve"), exports);
+__exportStar(require("./userPosition"), exports);
+__exportStar(require("./incentive"), exports);
+__exportStar(require("./instructions"), exports);
+__exportStar(require("./accounts"), exports);

package/dist/shared/lending-platforms/src/data/instructions/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./kamino";
+export * from "./lpInstructionsBase";
+export * from "./types";

package/dist/shared/lending-platforms/src/data/instructions/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./kamino"), exports);
+__exportStar(require("./lpInstructionsBase"), exports);
+__exportStar(require("./types"), exports);

package/dist/shared/lending-platforms/src/data/instructions/kamino.d.ts

@@ -0,0 +1,55 @@
+import { Address, Instruction, Rpc, SolanaRpcApi } from "@solana/kit";
+import { CpiData } from "common";
+import { LendingOperationParams, LpInstructionsBase, RepayOperationParams, SplitLpOperationCpiData } from "./lpInstructionsBase";
+import { RefreshPrerequisiteTarget } from "./types";
+import { KaminoData } from "../platform";
+import { KaminoAccounts } from "../accounts";
+/**
+ * Instruction builder for Kamino Lend protocol.
+ * Provides methods to build CPI account metas for lending operations.
+ */
+export declare class KaminoInstructions extends LpInstructionsBase<KaminoData> {
+    accounts: KaminoAccounts;
+    programId: Address;
+    lookupTable: Address<"bzdjSeDDPEdsGpK73oevQ87x4Sm6QRsnzupPLQEaFFN">;
+    constructor(rpc: Rpc<SolanaRpcApi>, rpcUrl: string, data: KaminoData, accounts: KaminoAccounts);
+    clearTransactionCache(txId?: string): void;
+    private getUserAccountCacheInvalidations;
+    private getInitUserMetadataCpiData;
+    getInitLendingPositionCpiData(params: {
+        pool: Address;
+        user: Address;
+        payer: Address;
+        userAccountId: number;
+        collateralReserve: Address;
+        debtReserve: Address;
+    }): Promise<SplitLpOperationCpiData>;
+    getInitUserAccountCpiData(pool: Address, user: Address, payer: Address, id: number, userLookupTable?: Address): Promise<SplitLpOperationCpiData>;
+    private getInitObligationFarmsForReserveCpiData;
+    /**
+     * Returns CPI accounts for refreshing a reserve's state.
+     * Includes the market, reserve, and all configured oracle accounts.
+     */
+    private getRefreshReserveCpiData;
+    private getRefreshObligationCpiData;
+    private getRefreshObligationCpiDataFromReserves;
+    getPrerequisiteCpisForRefresh(targets: RefreshPrerequisiteTarget[]): Promise<CpiData[]>;
+    private getRefreshUserFarmCpiData;
+    /**
+     * Checks if refresh CPIs are needed for the given reserve and obligation.
+     * Also registers all involved reserves in the txReserves cache for getPreInstructions.
+     *
+     * The instruction `reserve` (collateral vs debt) is also listed on the obligation;
+     * `dedupeOrderedAddresses` ensures one RefreshReserve CPI per reserve pubkey.
+     */
+    private getRefreshCpisIfNeeded;
+    getPreInstructions(txId: string): Promise<Instruction[]>;
+    getClaimIncentiveCpiData(user: Address, payer: Address, pool: Address, reserve: Address, obligation: Address, farm: Address, userFarm: Address, mint: Address): Promise<CpiData[]>;
+    getRequestElevationGroupCpiData(elevationGroup: number, user: Address, obligation: Address, pool: Address, txId: string): Promise<CpiData>;
+    getInitAndDepositCpiData(params: LendingOperationParams, userAccountId: number): Promise<SplitLpOperationCpiData>;
+    getInitBorrowPositionCpiData(params: LendingOperationParams, collReserve: Address): Promise<SplitLpOperationCpiData>;
+    getDepositCpiData(params: LendingOperationParams): Promise<SplitLpOperationCpiData>;
+    getWithdrawCpiData(params: LendingOperationParams): Promise<SplitLpOperationCpiData>;
+    getBorrowCpiData(params: LendingOperationParams): Promise<SplitLpOperationCpiData>;
+    getRepayCpiData(params: RepayOperationParams): Promise<SplitLpOperationCpiData>;
+}