@kestrelfi/lyc-sdk 1.0.1

package/dist/shared/jupiter-helpers/src/types.d.ts

@@ -0,0 +1,66 @@
+import type { Address, AccountMeta } from "@solana/kit";
+import type { QuoteResponse } from "@jup-ag/api";
+/**
+ * Parameters for getting a Jupiter quote
+ */
+export interface JupiterQuoteParams {
+    /** Input token mint */
+    inputMint: Address;
+    /** Output token mint */
+    outputMint: Address;
+    /** Amount in smallest units (e.g., lamports for SOL) */
+    amount: number | bigint;
+    /** Slippage tolerance in basis points (default: 500 = 5%) */
+    slippageBps?: number;
+    /** Optional max accounts in swap instruction. Omitted lets Jupiter choose route complexity. */
+    maxAccounts?: number;
+    /**
+     * Whitelist of DEX names to route through. When set, `excludeDexes` is ignored.
+     * Useful for test environments where only specific DEXes have funded accounts
+     * (e.g. `["Raydium", "Whirlpool"]` on Surfpool).
+     */
+    dexes?: string[];
+    /** DEXes to exclude from routing. Ignored when `dexes` is set. */
+    excludeDexes?: string[];
+    /** Only use direct routes (no intermediate hops) */
+    onlyDirectRoutes?: boolean;
+    /**
+     * `ExactIn` (default): `amount` is input size. `ExactOut`: `amount` is desired output size.
+     */
+    swapMode?: "ExactIn" | "ExactOut";
+}
+/**
+ * Default quote-policy overrides applied by `JupiterSwapClient`.
+ *
+ * Core swap identity fields (`inputMint`, `outputMint`, `amount`) remain
+ * request-specific and are always supplied per quote call.
+ */
+export interface JupiterSwapClientConfig {
+    /** Default quote options merged into every `getQuote()` call. */
+    quoteDefaults?: Omit<Partial<JupiterQuoteParams>, "inputMint" | "outputMint" | "amount">;
+}
+/**
+ * Parameters for building a Jupiter swap transaction
+ */
+export interface JupiterSwapParams {
+    /** Quote response from getJupiterQuote */
+    quote: QuoteResponse;
+    /** Address that will execute the swap (can be a PDA for CPI) */
+    userPublicKey: Address;
+    /** Whether to wrap/unwrap SOL automatically (default: false for CPI) */
+    wrapAndUnwrapSol?: boolean;
+    /** Use dynamic compute unit limit (default: true) */
+    dynamicComputeUnitLimit?: boolean;
+}
+/**
+ * Extracted Jupiter instruction data for CPI
+ */
+export interface ExtractedJupiterInstruction {
+    /** Serialized instruction data as Uint8Array */
+    data: Uint8Array;
+    /** Account metas with proper writability flags (Kit format) */
+    accounts: AccountMeta[];
+    /** Address lookup tables used by the transaction */
+    lookupTables: Address[];
+}
+export type { QuoteResponse } from "@jup-ag/api";

package/dist/shared/jupiter-helpers/src/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/shared/lending-platforms/src/constants/cache.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `DataCache` category keys for `LendingPlatformData` and platform implementations.
+ * Prefer `data.poolCatKey` / `data.reserveCatKey` / `data.userAccountCatKey` when you have a data
+ * instance so subclasses stay consistent; import these constants for static references or other packages.
+ */
+export declare const LENDING_PLATFORM_DATA_CACHE_CATEGORY_POOL = "pool";
+export declare const LENDING_PLATFORM_DATA_CACHE_CATEGORY_RESERVE = "reserve";
+export declare const LENDING_PLATFORM_DATA_CACHE_CATEGORY_USER_ACCOUNT = "userAccount";

package/dist/shared/lending-platforms/src/constants/cache.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_USER_ACCOUNT = exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_RESERVE = exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_POOL = void 0;
+/**
+ * `DataCache` category keys for `LendingPlatformData` and platform implementations.
+ * Prefer `data.poolCatKey` / `data.reserveCatKey` / `data.userAccountCatKey` when you have a data
+ * instance so subclasses stay consistent; import these constants for static references or other packages.
+ */
+exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_POOL = "pool";
+exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_RESERVE = "reserve";
+exports.LENDING_PLATFORM_DATA_CACHE_CATEGORY_USER_ACCOUNT = "userAccount";

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

@@ -0,0 +1,3 @@
+export * from "./cache";
+export * from "./kamino";
+export * from "./lendingPosition";

package/dist/shared/lending-platforms/src/constants/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("./cache"), exports);
+__exportStar(require("./kamino"), exports);
+__exportStar(require("./lendingPosition"), exports);

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

@@ -0,0 +1,7 @@
+import { LendingPlatformAccounts } from "../types";
+export declare const KAMINO_FARMS_PROGRAM_ID: import("@solana/kit").Address<"FarmsPZpWu9i7Kky8tPN37rs2TpmMrAZrC7S7vJa91Hr">;
+export declare const KAMINO_SCOPE_PROGRAM_ID: import("@solana/kit").Address<"HFn8GnPADiny6XqUoWE8uRPPxb29ikn4yTuPa9MF2fWJ">;
+export declare const KAMINO_MAIN_MARKET: import("@solana/kit").Address<"7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF">;
+export declare const SOL_RESERVE: import("@solana/kit").Address<"d4A2prbA2whesmvHaL88BH6Ewn5N4bTSU2Ze8P6Bc4Q">;
+export declare const USDC_RESERVE: import("@solana/kit").Address<"D6q6wuQSrifJKZYpR1M8R4YawnLDtDsMmWM1NbBmgJ59">;
+export declare const KAMINO_ACCOUNTS: LendingPlatformAccounts;

package/dist/shared/lending-platforms/src/constants/kamino.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KAMINO_ACCOUNTS = exports.USDC_RESERVE = exports.SOL_RESERVE = exports.KAMINO_MAIN_MARKET = exports.KAMINO_SCOPE_PROGRAM_ID = exports.KAMINO_FARMS_PROGRAM_ID = void 0;
+const kit_1 = require("@solana/kit");
+exports.KAMINO_FARMS_PROGRAM_ID = (0, kit_1.address)("FarmsPZpWu9i7Kky8tPN37rs2TpmMrAZrC7S7vJa91Hr");
+exports.KAMINO_SCOPE_PROGRAM_ID = (0, kit_1.address)("HFn8GnPADiny6XqUoWE8uRPPxb29ikn4yTuPa9MF2fWJ");
+exports.KAMINO_MAIN_MARKET = (0, kit_1.address)("7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF");
+exports.SOL_RESERVE = (0, kit_1.address)("d4A2prbA2whesmvHaL88BH6Ewn5N4bTSU2Ze8P6Bc4Q");
+exports.USDC_RESERVE = (0, kit_1.address)("D6q6wuQSrifJKZYpR1M8R4YawnLDtDsMmWM1NbBmgJ59");
+exports.KAMINO_ACCOUNTS = {
+    [exports.KAMINO_MAIN_MARKET]: [
+        {
+            address: exports.SOL_RESERVE,
+            mintSymbol: "SOL",
+        },
+        {
+            address: (0, kit_1.address)("37Jk2zkz23vkAYBT66HM2gaqJuNg2nYLsCreQAVt5MWK"),
+            mintSymbol: "cbBTC",
+        },
+        {
+            address: (0, kit_1.address)("febGYTnFX4GbSGoFHFeJXUHgNaK53fB23uDins9Jp1E"),
+            mintSymbol: "wETH",
+        },
+        {
+            address: (0, kit_1.address)("DGQZWCY17gGtBUgdaFs1VreJWsodkjFxndPsskwFKGpp"),
+            mintSymbol: "JupSOL",
+        },
+        {
+            address: (0, kit_1.address)("CkgQnPbuHHwSv2mNdAKH79TKSqC6jsyttK9yh4MPH6z3"),
+            mintSymbol: "dfdvSOL",
+        },
+        {
+            address: exports.USDC_RESERVE,
+            mintSymbol: "USDC",
+        },
+        {
+            address: (0, kit_1.address)("2gc9Dm1eB6UgVYFBUN9bWks6Kes9PbWSaPaa9DqyvEiN"),
+            mintSymbol: "PYUSD",
+        },
+        {
+            address: (0, kit_1.address)("ApQkX32ULJUzszZDe986aobLDLMNDoGQK8tRm6oD6SsA"),
+            mintSymbol: "CASH",
+        },
+        {
+            address: (0, kit_1.address)("ESCkPWKHmgNE7Msf77n9yzqJd5kQVWWGy3o5Mgxhvavp"),
+            mintSymbol: "USDG",
+        },
+        {
+            address: (0, kit_1.address)("BHUi32TrEsfN2U821G4FprKrR4hTeK4LCWtA3BFetuqA"),
+            mintSymbol: "USDS",
+        },
+        {
+            address: (0, kit_1.address)("H3t6qZ1JkguCNTi9uzVKqQ7dvt2cum4XiXWom6Gn5e5S"),
+            mintSymbol: "USDT",
+        },
+    ],
+    /// xStocks Market
+    [(0, kit_1.address)("5wJeMrUYECGq41fxRESKALVcHnNX26TAWy4W98yULsua")]: [
+        {
+            address: (0, kit_1.address)("2jerdAXR8r2B6z3P7P6VgSiePQX7wqcpbEqdDbm8mgeB"),
+            mintSymbol: "QQQx",
+        },
+        {
+            address: (0, kit_1.address)("UvXjBuC7YZYaGB9Rn1PpBD1GySmjzunXgE8Zev9ua8d"),
+            mintSymbol: "SPYx",
+        },
+        {
+            address: (0, kit_1.address)("97zoywd8mPZsGTg8q1wdD2Wgkdrs2tqusp1Qqcxbyj7E"),
+            mintSymbol: "USDC",
+        },
+    ],
+    // Bitcoin Market
+    // [address("GMqmFygF5iSm5nkckYU6tieggFcR42SyjkkhK5rswFRs")]: [
+    //   {
+    //     address: address("2Xd86oYAuhiKtQMVJBuWvJYxrSippreb46PmehGszpPQ"),
+    //     mintSymbol: "wBTC"
+    //   },
+    //   {
+    //     address: address("9FRZvAsjDJ6WM8BJ2S45h9PoDCLAq8DNY9zZDX7MyGzT"),
+    //     mintSymbol: "USDC"
+    //   }
+    // ]
+};

package/dist/shared/lending-platforms/src/constants/lendingPosition.d.ts

@@ -0,0 +1,7 @@
+/** Maximum value for `targetUtilizationRateBps` (100% LTV utilization). */
+export declare const MAX_TARGET_UTILIZATION_RATE_BPS = 10000;
+/**
+ * Maximum unwind-trigger utilization: `target + maxDeviationAbove`.
+ * Mirrors `MAX_LENDING_POSITION_UPPER_UTIL_BPS` in the on-chain program.
+ */
+export declare const MAX_LENDING_POSITION_UPPER_UTIL_BPS = 10500;

package/dist/shared/lending-platforms/src/constants/lendingPosition.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_LENDING_POSITION_UPPER_UTIL_BPS = exports.MAX_TARGET_UTILIZATION_RATE_BPS = void 0;
+/** Maximum value for `targetUtilizationRateBps` (100% LTV utilization). */
+exports.MAX_TARGET_UTILIZATION_RATE_BPS = 10000;
+/**
+ * Maximum unwind-trigger utilization: `target + maxDeviationAbove`.
+ * Mirrors `MAX_LENDING_POSITION_UPPER_UTIL_BPS` in the on-chain program.
+ */
+exports.MAX_LENDING_POSITION_UPPER_UTIL_BPS = 10500;

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

@@ -0,0 +1,2 @@
+export * from "./kamino";
+export * from "./lpAccountsBase";

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

@@ -0,0 +1,18 @@
+"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("./lpAccountsBase"), exports);

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

@@ -0,0 +1,42 @@
+import { BN } from "@anchor-lang/core";
+import { Address } from "@solana/kit";
+import { KaminoData } from "../platform";
+import { LpAccountsBase } from "./lpAccountsBase";
+export declare class KaminoAccounts extends LpAccountsBase<KaminoData> {
+    getUserAccountAddress(pool: Address, user: Address, id: number): Promise<Address>;
+    getUserMetadataAddress(user: Address): Promise<Address<string>>;
+    /**
+     * Gets the obligation farm accounts for a reserve.
+     */
+    getFarmAccounts(pool: Address, reserve: Address, obligation: Address, farmMode: "collateral" | "debt"): Promise<{
+        userFarm: import("common").CustomAccountMeta;
+        farm: import("common").CustomAccountMeta;
+    }>;
+    /**
+     * Returns the obligationFarmUserState PDA addresses for all active farms
+     * (collateral and debt) on a reserve. The farm addresses themselves live on
+     * the Kamino LUTs; only the user-specific state needs the per-token LUT.
+     */
+    getUserFarmAddresses(pool: Address, reserve: Address, obligation: Address): Promise<Address[]>;
+    /**
+     * Get all relevant account metas needed for interacting with the Kamino lending market.
+     */
+    reserveInteractionDetails(user: Address, pool: Address, reserve: Address, obligation?: Address, amount?: number, baseUnitAmountOverride?: BN): Promise<{
+        baseUnitAmount: BN | undefined;
+        signer: import("common").CustomAccountMeta;
+        obligation: import("common").CustomAccountMeta | undefined;
+        reserve: import("common").CustomAccountMeta;
+        reserveFeeVault: import("common").CustomAccountMeta;
+        reserveLiquidityMint: import("common").CustomAccountMeta;
+        reserveLiquiditySupply: import("common").CustomAccountMeta;
+        reserveCollateralMint: import("common").CustomAccountMeta;
+        reserveCollateralSupply: import("common").CustomAccountMeta;
+        lendingMarket: import("common").CustomAccountMeta;
+        lendingMarketAuthority: import("common").CustomAccountMeta;
+        userLiquidityTa: import("common").CustomAccountMeta;
+        userCollateralTa: import("common").CustomAccountMeta;
+        liquidityMintTokenProgram: import("common").CustomAccountMeta;
+        collateralMintTokenProgram: import("common").CustomAccountMeta;
+        farmsProgram: import("common").CustomAccountMeta;
+    }>;
+}

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

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KaminoAccounts = void 0;
+const klend_sdk_1 = require("@kamino-finance/klend-sdk");
+const common_1 = require("common");
+const token_1 = require("@solana-program/token");
+const constants_1 = require("../../constants");
+const lpAccountsBase_1 = require("./lpAccountsBase");
+class KaminoAccounts extends lpAccountsBase_1.LpAccountsBase {
+    async getUserAccountAddress(pool, user, id) {
+        const market = await this.data.fetchMarket(pool);
+        const obligationType = new klend_sdk_1.VanillaObligation(market.programId, id);
+        return await obligationType.toPda(pool, user);
+    }
+    async getUserMetadataAddress(user) {
+        return (await (0, klend_sdk_1.userMetadataPda)(user, klend_sdk_1.PROGRAM_ID))[0];
+    }
+    /**
+     * Gets the obligation farm accounts for a reserve.
+     */
+    async getFarmAccounts(pool, reserve, obligation, farmMode) {
+        const emptyFarms = {
+            userFarm: (0, common_1.toCustomAccountMeta)(klend_sdk_1.PROGRAM_ID),
+            farm: (0, common_1.toCustomAccountMeta)(klend_sdk_1.PROGRAM_ID),
+        };
+        const reserveData = await this.data.fetchReserve(pool, reserve);
+        if (!reserveData) {
+            return emptyFarms;
+        }
+        const farmAddress = farmMode === "collateral"
+            ? reserveData.rawData.state.farmCollateral
+            : reserveData.rawData.state.farmDebt;
+        if (!farmAddress || farmAddress === klend_sdk_1.DEFAULT_PUBLIC_KEY) {
+            return emptyFarms;
+        }
+        const obligationFarmUserState = await (0, klend_sdk_1.obligationFarmStatePda)(farmAddress, obligation);
+        return {
+            userFarm: (0, common_1.toCustomAccountMeta)(obligationFarmUserState, true),
+            farm: (0, common_1.toCustomAccountMeta)(farmAddress, true),
+        };
+    }
+    /**
+     * Returns the obligationFarmUserState PDA addresses for all active farms
+     * (collateral and debt) on a reserve. The farm addresses themselves live on
+     * the Kamino LUTs; only the user-specific state needs the per-token LUT.
+     */
+    async getUserFarmAddresses(pool, reserve, obligation) {
+        const addresses = [];
+        for (const mode of ["collateral", "debt"]) {
+            const { farm, userFarm } = await this.getFarmAccounts(pool, reserve, obligation, mode);
+            if (farm.address !== klend_sdk_1.PROGRAM_ID) {
+                addresses.push(userFarm.address);
+            }
+        }
+        return addresses;
+    }
+    /**
+     * Get all relevant account metas needed for interacting with the Kamino lending market.
+     */
+    async reserveInteractionDetails(user, pool, reserve, obligation, amount, baseUnitAmountOverride) {
+        const reserveData = await this.data.fetchReserve(pool, reserve);
+        const liquidityMint = reserveData.mint.mint;
+        const liquidityMintTokenProgram = reserveData.mint.mintTokenProgram;
+        const collateralMint = reserveData.rawData.state.collateral.mintPubkey;
+        const collateralMintTokenProgram = token_1.TOKEN_PROGRAM_ADDRESS;
+        const userLiquidityTaSeeds = {
+            mint: liquidityMint,
+            owner: user,
+            tokenProgram: liquidityMintTokenProgram,
+        };
+        const userLiquidityTa = await (0, common_1.getAtaAddress)(liquidityMint, user, liquidityMintTokenProgram);
+        const userCollateralTaSeeds = {
+            mint: collateralMint,
+            owner: user,
+            tokenProgram: collateralMintTokenProgram,
+        };
+        const userCollateralTa = await (0, common_1.getAtaAddress)(collateralMint, user, collateralMintTokenProgram);
+        const reserveLiquiditySupply = reserveData.rawData.state.liquidity.supplyVault;
+        const reserveCollateralSupply = reserveData.rawData.state.collateral.supplyVault;
+        return {
+            baseUnitAmount: baseUnitAmountOverride !== undefined
+                ? baseUnitAmountOverride
+                : amount !== undefined
+                    ? (0, common_1.fromUiAmount)(amount, reserveData.mint.mintDecimals)
+                    : undefined,
+            signer: (0, common_1.toCustomAccountMeta)(user, true),
+            obligation: obligation ? (0, common_1.toCustomAccountMeta)(obligation, true) : undefined,
+            reserve: (0, common_1.toCustomAccountMeta)(reserve, true),
+            reserveFeeVault: (0, common_1.toCustomAccountMeta)(reserveData.rawData.state.liquidity.feeVault, true),
+            reserveLiquidityMint: (0, common_1.toCustomAccountMeta)(liquidityMint),
+            reserveLiquiditySupply: (0, common_1.toCustomAccountMeta)(reserveLiquiditySupply, true),
+            reserveCollateralMint: (0, common_1.toCustomAccountMeta)(collateralMint, true),
+            reserveCollateralSupply: (0, common_1.toCustomAccountMeta)(reserveCollateralSupply, true),
+            lendingMarket: (0, common_1.toCustomAccountMeta)(pool),
+            lendingMarketAuthority: (0, common_1.toCustomAccountMeta)((await (0, klend_sdk_1.lendingMarketAuthPda)(pool))[0]),
+            userLiquidityTa: (0, common_1.toCustomAccountMeta)(userLiquidityTa, true, userLiquidityTaSeeds),
+            userCollateralTa: (0, common_1.toCustomAccountMeta)(userCollateralTa, true, userCollateralTaSeeds),
+            liquidityMintTokenProgram: (0, common_1.toCustomAccountMeta)(liquidityMintTokenProgram),
+            collateralMintTokenProgram: (0, common_1.toCustomAccountMeta)(collateralMintTokenProgram),
+            farmsProgram: (0, common_1.toCustomAccountMeta)(constants_1.KAMINO_FARMS_PROGRAM_ID),
+        };
+    }
+}
+exports.KaminoAccounts = KaminoAccounts;

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

@@ -0,0 +1,7 @@
+import { Address } from "@solana/kit";
+import { LendingPlatformData } from "../platform";
+export declare abstract class LpAccountsBase<T extends LendingPlatformData> {
+    data: T;
+    constructor(data: T);
+    abstract getUserAccountAddress(pool: Address, user: Address, id: number): Promise<Address>;
+}

package/dist/shared/lending-platforms/src/data/accounts/lpAccountsBase.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LpAccountsBase = void 0;
+class LpAccountsBase {
+    constructor(data) {
+        this.data = data;
+    }
+}
+exports.LpAccountsBase = LpAccountsBase;

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

@@ -0,0 +1,35 @@
+import { Address } from "@solana/kit";
+import { PositionBalanceChange } from "../../types";
+/**
+ * Categorizes when an incentive reward applies:
+ * - LendingOnly: Only for lending
+ * - BorrowingOnly: Only for borroweing
+ * - Pair: Requires both collateral and debt in specific reserves
+ */
+export declare enum IncentiveType {
+    LendingOnly = "Lending",
+    BorrowingOnly = "Borrowing",
+    Pair = "Pair"
+}
+interface IncentiveConfig {
+    rewardMint: Address;
+    incentiveType: IncentiveType;
+    /** If set, this incentive only applies when paired with this reserve */
+    requiresPairReserve?: Address;
+}
+/**
+ * Abstract base class for token reward incentives on lending reserves.
+ * Incentives can apply to deposits, borrows, or paired positions.
+ */
+export declare abstract class TokenIncentiveBase {
+    address: Address;
+    config: IncentiveConfig;
+    constructor(address: Address, config: IncentiveConfig);
+    /** Returns true if the incentive is currently active and emitting rewards */
+    abstract active(): boolean;
+    /** Returns the current APY from this incentive */
+    abstract apy(): number;
+    /** Simulates the APY after a hypothetical position change after changing total collateral deposits or debt borrows */
+    abstract simulateNewAPY(args: PositionBalanceChange): number;
+}
+export {};

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenIncentiveBase = exports.IncentiveType = void 0;
+/**
+ * Categorizes when an incentive reward applies:
+ * - LendingOnly: Only for lending
+ * - BorrowingOnly: Only for borroweing
+ * - Pair: Requires both collateral and debt in specific reserves
+ */
+var IncentiveType;
+(function (IncentiveType) {
+    IncentiveType["LendingOnly"] = "Lending";
+    IncentiveType["BorrowingOnly"] = "Borrowing";
+    IncentiveType["Pair"] = "Pair";
+})(IncentiveType || (exports.IncentiveType = IncentiveType = {}));
+/**
+ * Abstract base class for token reward incentives on lending reserves.
+ * Incentives can apply to deposits, borrows, or paired positions.
+ */
+class TokenIncentiveBase {
+    constructor(address, config) {
+        this.address = address;
+        this.config = config;
+    }
+}
+exports.TokenIncentiveBase = TokenIncentiveBase;

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

@@ -0,0 +1,2 @@
+export * from "./incentiveBase";
+export * from "./kamino";

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

@@ -0,0 +1,18 @@
+"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("./incentiveBase"), exports);
+__exportStar(require("./kamino"), exports);

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

@@ -0,0 +1,55 @@
+import { Address } from "@solana/kit";
+import { BN } from "@anchor-lang/core";
+import { TokenIncentiveBase } from "./incentiveBase";
+import { FarmAndKey, FarmState, RewardInfo } from "@kamino-finance/farms-sdk";
+import { PositionBalanceChange } from "../../types";
+import { KaminoReserve, KlendPrices } from "@kamino-finance/klend-sdk";
+/** Arguments for constructing a KaminoIncentiveData instance */
+export interface KaminoIncentiveDataArgs {
+    data: FarmAndKey;
+    /** Index of the reward within the farm's rewardInfos array */
+    rewardIndex: number;
+    /** If set, this incentive requires a paired position with this reserve */
+    requiresPairReserve?: Address;
+    /** True if this is a debt farm (rewards borrowers), false for collateral farm */
+    isDebtFarm: boolean;
+}
+/**
+ * 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.
+ */
+export declare class KaminoIncentiveData extends TokenIncentiveBase {
+    rawReserve: KaminoReserve;
+    rawFarm: FarmState;
+    rewardInfo: RewardInfo;
+    isDebtFarm: boolean;
+    private exchangeRate;
+    private rewardMintPrice;
+    /**
+     * Creates a KaminoIncentiveData instance from farm and reserve data.
+     * Determines the incentive type and calculates current exchange rates.
+     */
+    static loadData(args: KaminoIncentiveDataArgs, reserve: KaminoReserve, prices: KlendPrices, slot: bigint): KaminoIncentiveData;
+    /**
+     * 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(): boolean;
+    /** Calculates the current APY based on total staked amount and reward emission rate */
+    apy(): number;
+    /**
+     * Simulates the APY after a hypothetical position change.
+     * Useful for calculating expected rewards before executing a transaction.
+     */
+    simulateNewAPY(args: PositionBalanceChange): number;
+    /**
+     * Returns staking metrics for APY calculation.
+     * Falls back to reserve decimals if farm token decimals are not set.
+     */
+    protected getStakedTokenData(): {
+        totalStaked: BN;
+        stakedTokenDecimals: number;
+    };
+}