@kestrelfi/lyc-sdk 1.0.1

package/dist/shared/perena-helpers/src/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERENA_PROGRAM_ID = void 0;
+const kit_1 = require("@solana/kit");
+/**
+ * Perena Bankineco Program ID (prod)
+ */
+exports.PERENA_PROGRAM_ID = (0, kit_1.address)("save8RQVPMWNTzU18t3GBvBkN9hT7jsGjiCQ28FpD9H");

package/dist/shared/perena-helpers/src/cpi/burn.d.ts

@@ -0,0 +1,27 @@
+import { BN } from "@anchor-lang/core";
+/**
+ * Inner arguments for Perena burn CPI.
+ *
+ * Matches Rust `PerenaBurnArgs` in perena_helpers/src/cpi/burn.rs.
+ * Borsh size: 16 bytes (2 × u64 LE).
+ */
+export interface PerenaBurnArgs {
+    /** Amount of USD* to burn */
+    amountToBurn: bigint | BN | number;
+    /** Minimum yielding tokens to receive (slippage protection) */
+    minimumYieldingWithdrawn: bigint | BN | number;
+}
+/**
+ * Get raw borsh bytes for Perena burn CPI args.
+ *
+ * Returns a 16-byte `Uint8Array` (2 × u64 LE) — no length prefix.
+ * Pass the result to `CpiArgsBuilder.add()` or `serializeArgs()`.
+ *
+ * @example
+ * ```typescript
+ * const cpiArgs = new CpiArgsBuilder()
+ *   .add(getPerenaBurnArgs({ amountToBurn: 1_000_000, minimumYieldingWithdrawn: 900_000 }))
+ *   .build();
+ * ```
+ */
+export declare function getPerenaBurnArgs(data: PerenaBurnArgs): Uint8Array;

package/dist/shared/perena-helpers/src/cpi/burn.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPerenaBurnArgs = getPerenaBurnArgs;
+/**
+ * Get raw borsh bytes for Perena burn CPI args.
+ *
+ * Returns a 16-byte `Uint8Array` (2 × u64 LE) — no length prefix.
+ * Pass the result to `CpiArgsBuilder.add()` or `serializeArgs()`.
+ *
+ * @example
+ * ```typescript
+ * const cpiArgs = new CpiArgsBuilder()
+ *   .add(getPerenaBurnArgs({ amountToBurn: 1_000_000, minimumYieldingWithdrawn: 900_000 }))
+ *   .build();
+ * ```
+ */
+function getPerenaBurnArgs(data) {
+    const buf = Buffer.alloc(16);
+    buf.writeBigUInt64LE(BigInt(data.amountToBurn.toString()), 0);
+    buf.writeBigUInt64LE(BigInt(data.minimumYieldingWithdrawn.toString()), 8);
+    return buf;
+}

package/dist/shared/perena-helpers/src/cpi/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./mint";
+export * from "./burn";
+export * from "./requestUnstake";

package/dist/shared/perena-helpers/src/cpi/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("./mint"), exports);
+__exportStar(require("./burn"), exports);
+__exportStar(require("./requestUnstake"), exports);

package/dist/shared/perena-helpers/src/cpi/mint.d.ts

@@ -0,0 +1,27 @@
+import { BN } from "@anchor-lang/core";
+/**
+ * Inner arguments for Perena mint CPI.
+ *
+ * Matches Rust `PerenaMintArgs` in perena_helpers/src/cpi/mint.rs.
+ * Borsh size: 16 bytes (2 × u64 LE).
+ */
+export interface PerenaMintArgs {
+    /** Amount of yielding tokens to deposit (e.g., USDC amount) */
+    amountYieldingDeposit: bigint | BN | number;
+    /** Minimum USD* to receive (slippage protection) */
+    minBankMintMinted: bigint | BN | number;
+}
+/**
+ * Get raw borsh bytes for Perena mint CPI args.
+ *
+ * Returns a 16-byte `Uint8Array` (2 × u64 LE) — no length prefix.
+ * Pass the result to `CpiArgsBuilder.add()` or `serializeArgs()`.
+ *
+ * @example
+ * ```typescript
+ * const cpiArgs = new CpiArgsBuilder()
+ *   .add(getPerenaMintArgs({ amountYieldingDeposit: 1_000_000, minBankMintMinted: 900_000 }))
+ *   .build();
+ * ```
+ */
+export declare function getPerenaMintArgs(data: PerenaMintArgs): Uint8Array;

package/dist/shared/perena-helpers/src/cpi/mint.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPerenaMintArgs = getPerenaMintArgs;
+/**
+ * Get raw borsh bytes for Perena mint CPI args.
+ *
+ * Returns a 16-byte `Uint8Array` (2 × u64 LE) — no length prefix.
+ * Pass the result to `CpiArgsBuilder.add()` or `serializeArgs()`.
+ *
+ * @example
+ * ```typescript
+ * const cpiArgs = new CpiArgsBuilder()
+ *   .add(getPerenaMintArgs({ amountYieldingDeposit: 1_000_000, minBankMintMinted: 900_000 }))
+ *   .build();
+ * ```
+ */
+function getPerenaMintArgs(data) {
+    const buf = Buffer.alloc(16);
+    buf.writeBigUInt64LE(BigInt(data.amountYieldingDeposit.toString()), 0);
+    buf.writeBigUInt64LE(BigInt(data.minBankMintMinted.toString()), 8);
+    return buf;
+}

package/dist/shared/perena-helpers/src/cpi/requestUnstake.d.ts

@@ -0,0 +1,19 @@
+import { BN } from "@anchor-lang/core";
+/**
+ * Inner arguments for Perena request_unstake_junior CPI.
+ *
+ * Matches the Anchor `request_unstake_junior` instruction args.
+ * Borsh size: 9 bytes (1 × u64 LE + 1 × u8).
+ */
+export interface PerenaRequestUnstakeArgs {
+    /** Number of junior shares to lock in the withdrawal queue */
+    shares: BN | number;
+    /** Queue slot id (0–255) — unique per user per bank */
+    queueId: number;
+}
+/**
+ * Get raw borsh bytes for Perena request_unstake_junior CPI args.
+ *
+ * Returns a 9-byte `Uint8Array` (u64 LE + u8) — no length prefix.
+ */
+export declare function getPerenaRequestUnstakeArgs(data: PerenaRequestUnstakeArgs): Uint8Array;

package/dist/shared/perena-helpers/src/cpi/requestUnstake.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPerenaRequestUnstakeArgs = getPerenaRequestUnstakeArgs;
+const common_1 = require("common");
+/**
+ * Get raw borsh bytes for Perena request_unstake_junior CPI args.
+ *
+ * Returns a 9-byte `Uint8Array` (u64 LE + u8) — no length prefix.
+ */
+function getPerenaRequestUnstakeArgs(data) {
+    const sharesBytes = (0, common_1.numToU64Bytes)(data.shares);
+    const buf = Buffer.alloc(9);
+    Buffer.from(sharesBytes).copy(buf, 0);
+    buf.writeUInt8(data.queueId, 8);
+    return buf;
+}

package/dist/shared/perena-helpers/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./constants";
+export * from "./client";
+export * from "./accounts";
+export * from "./cpi";
+export * from "./utils";

package/dist/shared/perena-helpers/src/index.js

@@ -0,0 +1,21 @@
+"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("./constants"), exports);
+__exportStar(require("./client"), exports);
+__exportStar(require("./accounts"), exports);
+__exportStar(require("./cpi"), exports);
+__exportStar(require("./utils"), exports);

package/dist/shared/perena-helpers/src/utils.d.ts

@@ -0,0 +1,9 @@
+import type { Address } from "@solana/kit";
+import { type CpiData } from "common";
+import { PerenaClient } from "./client";
+/**
+ * Extract Perena withdrawal queue accounts referenced by request/fulfill-unstake
+ * CPI data.
+ */
+export declare function getPerenaWithdrawalQueueAddressesFromCpiData(cpiData: readonly CpiData[]): Address[];
+export declare function getGeneralLookupTableAccountsForPerena(perenaClient: PerenaClient): Promise<Address[]>;

package/dist/shared/perena-helpers/src/utils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPerenaWithdrawalQueueAddressesFromCpiData = getPerenaWithdrawalQueueAddressesFromCpiData;
+exports.getGeneralLookupTableAccountsForPerena = getGeneralLookupTableAccountsForPerena;
+const common_1 = require("common");
+/**
+ * Extract Perena withdrawal queue accounts referenced by request/fulfill-unstake
+ * CPI data.
+ */
+function getPerenaWithdrawalQueueAddressesFromCpiData(cpiData) {
+    return cpiData
+        .filter((cpi) => cpi.cpiType === common_1.CpiTypes.PERENA_REQUEST_UNSTAKE ||
+        cpi.cpiType === common_1.CpiTypes.PERENA_FULFILL_UNSTAKE)
+        .map((cpi) => cpi.accounts[2]?.address)
+        .filter((address) => address !== undefined);
+}
+async function getGeneralLookupTableAccountsForPerena(perenaClient) {
+    const bankMintInfo = common_1.mints.get("USD*");
+    const juniorMintInfo = common_1.mints.get("USD*-J");
+    const usdcMintInfo = common_1.mints.get("USDC");
+    if (!bankMintInfo || !juniorMintInfo || !usdcMintInfo) {
+        throw new Error("USD*, USD*-J, and USDC must exist in the mint registry");
+    }
+    const dummyUser = common_1.DEFAULT_PUBLIC_KEY;
+    const bankMintUserAta = await (0, common_1.getAtaAddress)(bankMintInfo.address, dummyUser, bankMintInfo.tokenProgram);
+    const juniorMintUserAta = await (0, common_1.getAtaAddress)(juniorMintInfo.address, dummyUser, juniorMintInfo.tokenProgram);
+    const usdcMintUserAta = await (0, common_1.getAtaAddress)(usdcMintInfo.address, dummyUser, usdcMintInfo.tokenProgram);
+    const allAccounts = [];
+    const stakeQuote = await perenaClient.getQuote({
+        inputMint: bankMintInfo.address,
+        outputMint: juniorMintInfo.address,
+        amount: (0, common_1.wholeTokenAmount)(bankMintInfo.decimals),
+        slippageBps: 50,
+    });
+    const stakeCpi = await perenaClient.getSwapCpiData(stakeQuote, dummyUser);
+    allAccounts.push(...(0, common_1.filterSpecificAccounts)(stakeCpi.accounts.map((account) => account.address), [common_1.DEFAULT_PUBLIC_KEY, bankMintUserAta, juniorMintUserAta]));
+    const mintQuote = await perenaClient.getQuote({
+        inputMint: usdcMintInfo.address,
+        outputMint: bankMintInfo.address,
+        amount: (0, common_1.wholeTokenAmount)(usdcMintInfo.decimals),
+        slippageBps: 50,
+    });
+    const mintCpi = await perenaClient.getSwapCpiData(mintQuote, dummyUser);
+    allAccounts.push(...(0, common_1.filterSpecificAccounts)(mintCpi.accounts.map((account) => account.address), [common_1.DEFAULT_PUBLIC_KEY, usdcMintUserAta, bankMintUserAta]));
+    const burnQuote = await perenaClient.getQuote({
+        inputMint: bankMintInfo.address,
+        outputMint: usdcMintInfo.address,
+        amount: (0, common_1.wholeTokenAmount)(bankMintInfo.decimals),
+        slippageBps: 50,
+    });
+    const burnCpi = await perenaClient.getSwapCpiData(burnQuote, dummyUser);
+    allAccounts.push(...(0, common_1.filterSpecificAccounts)(burnCpi.accounts.map((account) => account.address), [common_1.DEFAULT_PUBLIC_KEY, bankMintUserAta, usdcMintUserAta]));
+    return (0, common_1.dedupeOrderedAddresses)(allAccounts);
+}

package/dist/shared/swap-aggregator/src/aggSwapClient.d.ts

@@ -0,0 +1,71 @@
+import { type Address } from "@solana/kit";
+import { type CpiData, type SwapClient, type SwapQuoteParams, type SwapQuoteCoveringMinOutputParams, type SwapQuote, type SwapInstructionOptions, type Environment } from "common";
+import { type JupiterSwapClientConfig } from "jupiter-helpers";
+/**
+ * Internal wrapper around a sub-client's quote so we can route
+ * `getSwapCpiData` back to the correct client.
+ */
+interface AggRawQuote {
+    routeKey: string;
+    innerQuote: SwapQuote<any>;
+}
+export type AggSwapQuote = SwapQuote<AggRawQuote>;
+/**
+ * Optional routing-policy overrides for the aggregate swap client.
+ */
+export interface AggSwapClientConfig {
+    /** Optional default quote policy passed through to the Jupiter fallback client. */
+    jupiter?: JupiterSwapClientConfig;
+}
+export declare function createAggSwapClient(rpcUrl: string, environment: Environment): AggSwapClient;
+/**
+ * Aggregating swap client that routes to the best available swap
+ * implementation based on {@link swapClientCanRoute} over an ordered list
+ * of {@link RoutableSwapClient}s (Perena first, then Jupiter).
+ *
+ * Routing priority:
+ *   1. **Perena** — when the pair is routable per Perena’s mint lists and anchors
+ *   2. **Jupiter** — fallback (wildcard routing metadata)
+ *
+ * @example
+ * ```typescript
+ * const swapClient = new AggSwapClient(rpcUrl);
+ *
+ * // USD* <-> USDC goes through Perena
+ * const quote = await swapClient.getQuote({
+ *   inputMint: USD_STAR_MINT,
+ *   outputMint: USDC_MINT,
+ *   amount: 10_000_000,
+ * });
+ *
+ * // USD*-J -> USD* goes through Perena
+ * const quote2 = await swapClient.getQuote({
+ *   inputMint: USD_STAR_J_MINT,
+ *   outputMint: USD_STAR_MINT,
+ *   amount: 10_000_000,
+ * });
+ *
+ * // SOL -> USDC goes through Jupiter
+ * const quote3 = await swapClient.getQuote({
+ *   inputMint: SOL_MINT,
+ *   outputMint: USDC_MINT,
+ *   amount: 1_000_000_000,
+ * });
+ * ```
+ */
+export declare class AggSwapClient implements SwapClient<AggRawQuote> {
+    private readonly perena;
+    private readonly jupiter;
+    /** Priority order: first routable client wins. */
+    private readonly routeClients;
+    constructor(rpcUrl: string, config?: AggSwapClientConfig);
+    getQuote(params: SwapQuoteParams): Promise<AggSwapQuote>;
+    getSwapCpiData(quote: AggSwapQuote, userPublicKey: Address, options?: SwapInstructionOptions): Promise<CpiData>;
+    /**
+     * Route {@link SwapClient.getQuoteCoveringMinOutput} to the first backend that can
+     * handle the mint pair (Perena before Jupiter).
+     */
+    getQuoteCoveringMinOutput(params: SwapQuoteCoveringMinOutputParams): Promise<AggSwapQuote>;
+    private wrapQuote;
+}
+export {};

package/dist/shared/swap-aggregator/src/aggSwapClient.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggSwapClient = void 0;
+exports.createAggSwapClient = createAggSwapClient;
+const common_1 = require("common");
+const jupiter_helpers_1 = require("jupiter-helpers");
+const perena_helpers_1 = require("perena-helpers");
+function createAggSwapClient(rpcUrl, environment) {
+    return new AggSwapClient(rpcUrl, {
+        jupiter: environment === "local"
+            ? {
+                quoteDefaults: {
+                    excludeDexes: jupiter_helpers_1.LOCAL_TEST_EXCLUDED_DEXES,
+                    maxAccounts: jupiter_helpers_1.LOCAL_TEST_MAX_ACCOUNTS,
+                },
+            }
+            : undefined,
+    });
+}
+/**
+ * Aggregating swap client that routes to the best available swap
+ * implementation based on {@link swapClientCanRoute} over an ordered list
+ * of {@link RoutableSwapClient}s (Perena first, then Jupiter).
+ *
+ * Routing priority:
+ *   1. **Perena** — when the pair is routable per Perena’s mint lists and anchors
+ *   2. **Jupiter** — fallback (wildcard routing metadata)
+ *
+ * @example
+ * ```typescript
+ * const swapClient = new AggSwapClient(rpcUrl);
+ *
+ * // USD* <-> USDC goes through Perena
+ * const quote = await swapClient.getQuote({
+ *   inputMint: USD_STAR_MINT,
+ *   outputMint: USDC_MINT,
+ *   amount: 10_000_000,
+ * });
+ *
+ * // USD*-J -> USD* goes through Perena
+ * const quote2 = await swapClient.getQuote({
+ *   inputMint: USD_STAR_J_MINT,
+ *   outputMint: USD_STAR_MINT,
+ *   amount: 10_000_000,
+ * });
+ *
+ * // SOL -> USDC goes through Jupiter
+ * const quote3 = await swapClient.getQuote({
+ *   inputMint: SOL_MINT,
+ *   outputMint: USDC_MINT,
+ *   amount: 1_000_000_000,
+ * });
+ * ```
+ */
+class AggSwapClient {
+    constructor(rpcUrl, config = {}) {
+        this.perena = new perena_helpers_1.PerenaClient(rpcUrl);
+        this.jupiter = new jupiter_helpers_1.JupiterSwapClient((0, common_1.createRpcWithRetry)(rpcUrl), config.jupiter);
+        this.routeClients = [
+            { key: "perena", client: this.perena },
+            { key: "jupiter", client: this.jupiter },
+        ];
+    }
+    async getQuote(params) {
+        const match = this.routeClients.find(({ client }) => (0, common_1.swapClientCanRoute)(client, params.inputMint, params.outputMint));
+        if (!match) {
+            throw new Error("AggSwapClient: no backend can route this mint pair");
+        }
+        const innerQuote = await match.client.getQuote(params);
+        return this.wrapQuote(match.key, innerQuote);
+    }
+    async getSwapCpiData(quote, userPublicKey, options) {
+        const { routeKey, innerQuote } = quote.rawQuote;
+        const entry = this.routeClients.find((r) => r.key === routeKey);
+        if (!entry) {
+            throw new Error(`AggSwapClient: unknown routeKey ${routeKey}`);
+        }
+        return entry.client.getSwapCpiData(innerQuote, userPublicKey, options);
+    }
+    /**
+     * Route {@link SwapClient.getQuoteCoveringMinOutput} to the first backend that can
+     * handle the mint pair (Perena before Jupiter).
+     */
+    async getQuoteCoveringMinOutput(params) {
+        const match = this.routeClients.find(({ client }) => (0, common_1.swapClientCanRoute)(client, params.inputMint, params.outputMint));
+        if (!match) {
+            throw new Error("AggSwapClient: no backend can route this mint pair");
+        }
+        const innerQuote = await match.client.getQuoteCoveringMinOutput(params);
+        return this.wrapQuote(match.key, innerQuote);
+    }
+    wrapQuote(routeKey, innerQuote) {
+        return {
+            inputMint: innerQuote.inputMint,
+            outputMint: innerQuote.outputMint,
+            inputAmount: innerQuote.inputAmount,
+            outputAmount: innerQuote.outputAmount,
+            priceImpactPct: innerQuote.priceImpactPct,
+            rawQuote: { routeKey, innerQuote },
+        };
+    }
+}
+exports.AggSwapClient = AggSwapClient;

package/dist/shared/swap-aggregator/src/index.d.ts

@@ -0,0 +1 @@
+export * from "./aggSwapClient";

package/dist/shared/swap-aggregator/src/index.js

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

package/docs/launchingToken.md

@@ -0,0 +1,57 @@
+# Launching a New Token
+
+End-to-end steps to deploy a new yToken backed by a collateral (risk) asset.
+
+## 1. Register the risk asset in shared packages
+
+**Default mints** — add the collateral mint to `common/src/services/mints/defaults.ts` with the correct `address`, `symbol`, `decimals`, and `assetType` (`"Standard"` for most risk assets, `"LST"` for liquid staking tokens).
+
+**Oracle feed** — add a Pyth or Switchboard entry for the collateral symbol in `oracle-service/src/constants/pyth.ts` (or the relevant Switchboard constants file). The `create-token` script reads the oracle from this registry.
+
+**Lending platform accounts** — add reserves, pools, and any other protocol-specific accounts for the collateral and debt mints in `lending-platforms/src/constants/kamino.ts` (or the file for the relevant lending platform). Each reserve entry needs the on-chain reserve address and `mintSymbol`.
+
+## 2. Create the on-chain Token account
+
+```bash
+pnpm lyc:create-token {test|prod} {COLLATERAL_SYMBOL}
+```
+
+Example: `pnpm lyc:create-token test SOL`
+
+This mints a new yToken, derives the Token PDA, and calls `create_token` on-chain. Note the **Token PDA** printed in the output — you'll need it later.
+
+## 3. Create a lending position on the token
+
+```bash
+pnpm lyc:create-lp {test|prod} {TOKEN} {lowVol|highVol} [DEBT_SYMBOL] [POOL] [KEYPAIR_JSON]
+```
+
+Example: `pnpm lyc:create-lp test SOL lowVol USDC`
+
+`TOKEN` is the collateral symbol (e.g. `SOL`) or the Token PDA address. `DEBT_SYMBOL` defaults to `USDC`. `POOL` defaults to the Kamino main market. The script resolves carry trade presets for the collateral asset and volatility regime, reads `maxLtv` and `liquidationThreshold` from on-chain reserves, and computes the lending allocation config.
+
+## 4. Update lookup tables
+
+Run all three in order:
+
+```bash
+pnpm kamino:update-lut
+pnpm lyc:update-general-lut {test|prod}
+pnpm lyc:update-token-luts {test|prod}
+```
+
+`kamino:update-lut` refreshes the Kamino lending platform LUT with any new reserves. `lyc:update-general-lut` refreshes the shared program LUT (program IDs, mints, oracles, yielding banks). `lyc:update-token-luts` creates or extends per-token LUTs with the token's mints, ATAs, and lending accounts. New tokens without an existing LUT entry get a fresh one created automatically.
+
+## 5. Register the new token lookup table
+
+After `lyc:update-token-luts` runs, it logs the address of any newly created lookup table. Add it to `TOKEN_LOOKUP_TABLES` in `typescript/sdks/long-yield-carry/src/constants/general.ts`, keyed by the Token PDA:
+
+```ts
+export const TOKEN_LOOKUP_TABLES: Record<Address, Address> = {
+  // TEST
+  [address("<TOKEN_PDA>")]: address("<NEW_LUT_ADDRESS>"),
+  // ...
+};
+```
+
+This mapping is used by `mergeLycLookupTables` to attach the correct per-token LUT to every transaction involving that token.

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@kestrelfi/lyc-sdk",
+  "version": "1.0.1",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "dependencies": {
+    "@anchor-lang/core": "=0.32.1",
+    "@anchor-lang/errors": "=0.32.1",
+    "@anchor-lang/spl-token": "=0.32.1",
+    "@solana-program/address-lookup-table": "=0.7.0",
+    "@solana-program/system": "=0.10.0",
+    "@solana-program/token": "=0.5.1",
+    "@solana-program/token-2022": "=0.6.1",
+    "bs58": "5.0.0",
+    "common": "file:../../shared/common",
+    "dotenv": "^17.3.1",
+    "lending-platforms": "file:../../shared/lending-platforms",
+    "oracle": "file:../../shared/oracle-service",
+    "perena-helpers": "file:../../shared/perena-helpers",
+    "swap-aggregator": "file:../../shared/swap-aggregator"
+  },
+  "devDependencies": {
+    "@solana/web3.js": "=1.98.4",
+    "@types/bn.js": "^5.1.0",
+    "@types/chai": "^4.3.0",
+    "@types/mocha": "^9.0.0",
+    "chai": "^4.3.4",
+    "mocha": "^9.0.3",
+    "prettier": "^2.6.2",
+    "ts-mocha": "^10.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint:fix": "prettier */*.js \"*/**/*{.js,.ts}\" -w",
+    "lint": "prettier */*.js \"*/**/*{.js,.ts}\" --check",
+    "refresh": "tsx scripts/refresh.ts",
+    "update-general-lut": "tsx scripts/updateGeneralLut.ts",
+    "update-token-luts": "tsx scripts/updateTokenLuts.ts",
+    "create-token": "tsx scripts/createToken.ts",
+    "create-yielding-bank": "tsx scripts/createYieldingBank.ts",
+    "rebalance-yielding-bank": "tsx scripts/rebalanceYieldingBank.ts",
+    "mint-token": "tsx scripts/mintToken.ts",
+    "burn-token": "tsx scripts/burnToken.ts",
+    "async-burn": "tsx scripts/asyncBurn.ts",
+    "process-async-burns": "tsx scripts/processAsyncBurns.ts",
+    "deposit-unlent": "tsx scripts/depositUnlentCollateral.ts",
+    "withdraw-unlent": "tsx scripts/withdrawUnlentCollateral.ts",
+    "create-lp": "tsx scripts/createTokenLendingPosition.ts",
+    "update-lp-config": "tsx scripts/updateLendingPositionConfig.ts",
+    "inspect": "tsx scripts/inspect.ts",
+    "trigger-cb": "tsx scripts/emergency/triggerCircuitBreaker.ts",
+    "deleverage-all": "tsx scripts/emergency/deleverageAll.ts",
+    "update-token-metadata": "tsx scripts/updateTokenMetadata.ts",
+    "recollateralize-loss": "tsx scripts/recollateralizeLoss.ts",
+    "increase-carry": "tsx scripts/increaseCarryPositions.ts",
+    "decrease-carry": "tsx scripts/decreaseCarryPositions.ts",
+    "collect-interest": "tsx scripts/collectInterest.ts",
+    "collect-protocol-fees": "tsx scripts/collectProtocolFees.ts",
+    "reclaim-excess-rent": "tsx scripts/reclaimExcessRent.ts",
+    "close-cpi-plans": "tsx scripts/closeCpiPlans.ts",
+    "claim-incentives": "tsx scripts/claimIncentives.ts",
+    "update-yb-config": "tsx scripts/updateYieldingBankConfig.ts",
+    "compute-optimal-allocations": "tsx scripts/computeOptimalAllocations.ts",
+    "update-fees": "tsx scripts/updateFees.ts",
+    "rebalance-token": "tsx scripts/rebalanceToken.ts",
+    "debug:burn-yeth-all": "tsx scripts/debugBurnYethAll.ts",
+    "find-txs": "tsx scripts/findTxs.ts"
+  }
+}