@kestrelfi/lyc-sdk 1.0.1 → 1.0.3

package/dist/sdks/long-yield-carry/src/utils/transactions.js

@@ -1,72 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.composePhasedTransactionPlan = composePhasedTransactionPlan;
-exports.setTokenCircuitBreaker = setTokenCircuitBreaker;
-exports.setYieldingBankCircuitBreaker = setYieldingBankCircuitBreaker;
-exports.createYTokenMint = createYTokenMint;
-const kit_1 = require("@solana/kit");
-const token_1 = require("@solana-program/token");
-const common_1 = require("common");
-const data_1 = require("./data");
-/**
- * Compose ordered phases into one bundle-ready plan without making an entire
- * phase indivisible. Existing atomic segments are preserved, and each phase
- * after the first is forced to start in a new transaction.
- */
-function composePhasedTransactionPlan(phases) {
-    if (phases.length === 0) {
-        throw new Error("Cannot compose an empty transaction phase list.");
-    }
-    if (phases.length === 1) {
-        return phases[0];
-    }
-    const segmentLengths = [];
-    const freshBinSegments = new Set();
-    let segmentOffset = 0;
-    for (const [phaseIndex, phase] of phases.entries()) {
-        const phaseSegmentLengths = phase.segmentLengths?.length === 0 || phase.segmentLengths === undefined
-            ? phase.instructions.map(() => 1)
-            : phase.segmentLengths;
-        if (phaseIndex > 0) {
-            freshBinSegments.add(segmentOffset);
-        }
-        for (const segmentIndex of phase.freshBinSegments ?? []) {
-            freshBinSegments.add(segmentOffset + segmentIndex);
-        }
-        segmentLengths.push(...phaseSegmentLengths);
-        segmentOffset += phaseSegmentLengths.length;
-    }
-    return {
-        instructions: phases.flatMap((phase) => phase.instructions),
-        lookupTables: [...new Set(phases.flatMap((phase) => phase.lookupTables ?? []))],
-        segmentLengths,
-        freshBinSegments: [...freshBinSegments].sort((a, b) => a - b),
-        postSuccessCacheInvalidations: phases.flatMap((phase) => phase.postSuccessCacheInvalidations ?? []),
-    };
-}
-async function setTokenCircuitBreaker(client, signer, token, active) {
-    const plan = await client.tx.setTokenCircuitBreaker.getTx({
-        authority: signer.address,
-        token,
-        active,
-    });
-    return client.sendTransaction(signer, plan);
-}
-async function setYieldingBankCircuitBreaker(client, signer, yieldingBank, active) {
-    const plan = await client.tx.setYieldingBankCircuitBreaker.getTx({
-        authority: signer.address,
-        yieldingBank,
-        active,
-    });
-    return client.sendTransaction(signer, plan);
-}
-/**
- * Creates a new yToken SPL mint with mint authority = token PDA, using the next free token ID.
- */
-async function createYTokenMint(client, payer, decimals = 6, tokenProgram = token_1.TOKEN_PROGRAM_ADDRESS) {
-    const mintSigner = await (0, kit_1.generateKeyPairSigner)();
-    const id = await (0, data_1.findFreeTokenId)(client, mintSigner.address);
-    const [tokenPda, tokenPdaBump] = await client.pda.deriveTokenPda(mintSigner.address, id);
-    await (0, common_1.createMint)(client.rpc, payer, mintSigner, tokenPda, decimals, tokenProgram);
-    return { mintSigner, tokenPda, tokenPdaBump, id };
-}

package/dist/sdks/long-yield-carry/src/utils/yieldingBank.d.ts

@@ -1,24 +0,0 @@
-import type { Address } from "@solana/kit";
-import { type LendingPlatform } from "common";
-import type { LYCToken } from "../models/lycToken";
-import type { LYCYieldingBank } from "../models/yieldingBank";
-/**
- * Returns the first active yielding bank (circuit breaker off, lowest id).
- *
- * TODO: This naively returns the first active bank regardless of what the
- * lending position actually borrows. It works today because there is one
- * yielding bank (USDC) and all debt is denominated in USDC. When a second
- * yielding bank exists (e.g. SOL-denominated) or a lending position borrows
- * a non-USDC asset, the carry-manager would route that debt into the wrong
- * bank. At that point this function needs to accept the lending position's
- * debt mint and match it to the correct bank — either via the token's
- * existing `debtCarry` entries or an explicit per-token bank configuration.
- *
- * @returns The yielding bank address, or `null` if no active bank exists.
- */
-export declare function resolveYieldingBankForPosition(allBanks: LYCYieldingBank[]): Address | null;
-/**
- * Returns the index of the first active lending position for the given
- * platform, or `null` if the token has no positions on that platform.
- */
-export declare function firstActiveLendingIndex(token: LYCToken, platform: LendingPlatform): number | null;

package/dist/sdks/long-yield-carry/src/utils/yieldingBank.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveYieldingBankForPosition = resolveYieldingBankForPosition;
-exports.firstActiveLendingIndex = firstActiveLendingIndex;
-const common_1 = require("common");
-/**
- * Returns the first active yielding bank (circuit breaker off, lowest id).
- *
- * TODO: This naively returns the first active bank regardless of what the
- * lending position actually borrows. It works today because there is one
- * yielding bank (USDC) and all debt is denominated in USDC. When a second
- * yielding bank exists (e.g. SOL-denominated) or a lending position borrows
- * a non-USDC asset, the carry-manager would route that debt into the wrong
- * bank. At that point this function needs to accept the lending position's
- * debt mint and match it to the correct bank — either via the token's
- * existing `debtCarry` entries or an explicit per-token bank configuration.
- *
- * @returns The yielding bank address, or `null` if no active bank exists.
- */
-function resolveYieldingBankForPosition(allBanks) {
-    const candidates = allBanks.filter((b) => b.circuitBreaker === 0).sort((a, b) => a.id - b.id);
-    return candidates[0]?.address ?? null;
-}
-/**
- * Returns the index of the first active lending position for the given
- * platform, or `null` if the token has no positions on that platform.
- */
-function firstActiveLendingIndex(token, platform) {
-    const positions = token.data.lendingPositions;
-    for (let i = 0; i < positions.length; i++) {
-        if ((0, common_1.lendingPlatformToEnum)(positions[i].platform) === platform) {
-            return i;
-        }
-    }
-    return null;
-}

package/dist/shared/common/src/constants/accountMetas.d.ts

@@ -1,3 +0,0 @@
-export declare const RENT_SYSVAR_META: import("..").CustomAccountMeta;
-export declare const SYSTEM_PROGRAM_META: import("..").CustomAccountMeta;
-export declare const IX_SYSVAR_META: import("..").CustomAccountMeta;

package/dist/shared/common/src/constants/accountMetas.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IX_SYSVAR_META = exports.SYSTEM_PROGRAM_META = exports.RENT_SYSVAR_META = void 0;
-const sysvars_1 = require("@solana/sysvars");
-const system_1 = require("@solana-program/system");
-const utils_1 = require("../utils");
-exports.RENT_SYSVAR_META = (0, utils_1.toCustomAccountMeta)(sysvars_1.SYSVAR_RENT_ADDRESS);
-exports.SYSTEM_PROGRAM_META = (0, utils_1.toCustomAccountMeta)(system_1.SYSTEM_PROGRAM_ADDRESS);
-exports.IX_SYSVAR_META = (0, utils_1.toCustomAccountMeta)(sysvars_1.SYSVAR_INSTRUCTIONS_ADDRESS);

package/dist/shared/common/src/constants/general.d.ts

@@ -1,21 +0,0 @@
-import { Address } from "@solana/kit";
-import type { DeployedEnv, Environment } from "../types";
-export declare const ENVIRONMENT: Environment;
-export declare const LAMPORTS_PER_SOL = 1000000000;
-export declare const DAYS_PER_YEAR = 365;
-export declare const TVL_USD_DECIMAL_PLACES = 8;
-export declare const TVL_USD_SCALE: bigint;
-export declare const BPS_DENOMINATOR = 10000n;
-export declare const DEFAULT_PUBLIC_KEY: Address;
-export declare const LOCALNET_URL = "http://127.0.0.1:8899";
-export declare const TP_ID_KEYPAIR_FP = "~/.config/solana/tp-id.json";
-export declare const TP_LUT_MANAGER_KP_FP = "~/.config/solana/tp-lut-manager.json";
-/**
- * Program-level admin pubkey shared across deployed programs (LYC protocol admin,
- * consensus oracle admin seed, etc.). Matches Rust `PROTOCOL_ADMIN`.
- */
-export declare const PROTOCOL_ADMIN: Record<Environment, Address>;
-/** Admin keypair paths for deployed (test/prod) CLI scripts. */
-export declare const DEPLOYED_ADMIN_KEYPAIR_FP: Record<DeployedEnv, string>;
-export declare const PRICE_STALENESS_SECONDS = 60;
-export declare const METAPLEX_TOKEN_METADATA_PROGRAM_ID: Address;

package/dist/shared/common/src/constants/general.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.METAPLEX_TOKEN_METADATA_PROGRAM_ID = exports.PRICE_STALENESS_SECONDS = exports.DEPLOYED_ADMIN_KEYPAIR_FP = exports.PROTOCOL_ADMIN = exports.TP_LUT_MANAGER_KP_FP = exports.TP_ID_KEYPAIR_FP = exports.LOCALNET_URL = exports.DEFAULT_PUBLIC_KEY = exports.BPS_DENOMINATOR = exports.TVL_USD_SCALE = exports.TVL_USD_DECIMAL_PLACES = exports.DAYS_PER_YEAR = exports.LAMPORTS_PER_SOL = exports.ENVIRONMENT = void 0;
-const kit_1 = require("@solana/kit");
-exports.ENVIRONMENT = process.env.ENVIRONMENT ?? "local";
-exports.LAMPORTS_PER_SOL = 1000000000;
-exports.DAYS_PER_YEAR = 365;
-exports.TVL_USD_DECIMAL_PLACES = 8;
-exports.TVL_USD_SCALE = BigInt(10 ** exports.TVL_USD_DECIMAL_PLACES);
-exports.BPS_DENOMINATOR = 10000n;
-exports.DEFAULT_PUBLIC_KEY = (0, kit_1.address)("11111111111111111111111111111111");
-exports.LOCALNET_URL = "http://127.0.0.1:8899";
-exports.TP_ID_KEYPAIR_FP = "~/.config/solana/tp-id.json";
-exports.TP_LUT_MANAGER_KP_FP = "~/.config/solana/tp-lut-manager.json";
-/**
- * Program-level admin pubkey shared across deployed programs (LYC protocol admin,
- * consensus oracle admin seed, etc.). Matches Rust `PROTOCOL_ADMIN`.
- */
-exports.PROTOCOL_ADMIN = {
-    local: (0, kit_1.address)("7PxS1VMxKbzUTF4sxeAw4LqBfnGMaeQH2KwabmUcVxYC"),
-    test: (0, kit_1.address)("8S1Ta7xZVsiqtf9mrUPwXKSNmBPzmsK3RdhonDu3kzk"),
-    prod: (0, kit_1.address)("7PxS1VMxKbzUTF4sxeAw4LqBfnGMaeQH2KwabmUcVxYC"), // TODO: mainnet admin
-};
-/** Admin keypair paths for deployed (test/prod) CLI scripts. */
-exports.DEPLOYED_ADMIN_KEYPAIR_FP = {
-    test: "~/.config/solana/tp-lyc-admin-test.json",
-    prod: "~/.config/solana/tp-lyc-admin-prod.json",
-};
-exports.PRICE_STALENESS_SECONDS = 60;
-exports.METAPLEX_TOKEN_METADATA_PROGRAM_ID = (0, kit_1.address)("metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s");

package/dist/shared/common/src/constants/generated/cpi.d.ts

@@ -1,23 +0,0 @@
-export declare const CpiTypes: {
-    readonly JUPITER_SWAP: 0;
-    readonly PERENA_MINT: 1;
-    readonly PERENA_BURN: 2;
-    readonly PERENA_STAKE: 3;
-    readonly PERENA_INSTANT_UNSTAKE: 4;
-    readonly PERENA_REQUEST_UNSTAKE: 5;
-    readonly PERENA_FULFILL_UNSTAKE: 6;
-    readonly K_INIT_USER_METADATA: 7;
-    readonly K_INIT_OBLIGATION: 8;
-    readonly K_INIT_USER_FARM: 9;
-    readonly K_REFRESH_RESERVE: 10;
-    readonly K_REFRESH_OBLIGATION: 11;
-    readonly K_REFRESH_USER_FARM: 12;
-    readonly K_HARVEST_REWARD: 13;
-    readonly K_REQUEST_ELEVATION_GROUP: 14;
-    readonly K_DEPOSIT: 15;
-    readonly K_WITHDRAW: 16;
-    readonly K_BORROW: 17;
-    readonly K_REPAY: 18;
-    readonly MPL_UPDATE_METADATA: 19;
-    readonly MPL_CREATE_METADATA: 20;
-};

package/dist/shared/common/src/constants/generated/cpi.js

@@ -1,28 +0,0 @@
-"use strict";
-// This file is auto-generated from the Rust CPI registry.
-// Do not edit manually. Run `cargo test -p common export_cpi_registry -- --ignored` to regenerate.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CpiTypes = void 0;
-exports.CpiTypes = {
-    JUPITER_SWAP: 0,
-    PERENA_MINT: 1,
-    PERENA_BURN: 2,
-    PERENA_STAKE: 3,
-    PERENA_INSTANT_UNSTAKE: 4,
-    PERENA_REQUEST_UNSTAKE: 5,
-    PERENA_FULFILL_UNSTAKE: 6,
-    K_INIT_USER_METADATA: 7,
-    K_INIT_OBLIGATION: 8,
-    K_INIT_USER_FARM: 9,
-    K_REFRESH_RESERVE: 10,
-    K_REFRESH_OBLIGATION: 11,
-    K_REFRESH_USER_FARM: 12,
-    K_HARVEST_REWARD: 13,
-    K_REQUEST_ELEVATION_GROUP: 14,
-    K_DEPOSIT: 15,
-    K_WITHDRAW: 16,
-    K_BORROW: 17,
-    K_REPAY: 18,
-    MPL_UPDATE_METADATA: 19,
-    MPL_CREATE_METADATA: 20,
-};

package/dist/shared/common/src/constants/generated/index.d.ts

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

package/dist/shared/common/src/constants/generated/index.js

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

package/dist/shared/common/src/constants/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./general";
-export * from "./accountMetas";
-export * from "./generated";

package/dist/shared/common/src/constants/index.js

@@ -1,19 +0,0 @@
-"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("./general"), exports);
-__exportStar(require("./accountMetas"), exports);
-__exportStar(require("./generated"), exports);

package/dist/shared/common/src/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./utils";
-export * from "./types";
-export * from "./constants";
-export * from "./services";

package/dist/shared/common/src/index.js

@@ -1,20 +0,0 @@
-"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("./utils"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./services"), exports);

package/dist/shared/common/src/services/baseAccountClient.d.ts

@@ -1,22 +0,0 @@
-import type { Address, Rpc, SolanaRpcApi } from "@solana/kit";
-import { DataCache, type CacheTtlConfig } from "./dataCache";
-/**
- * DataCache category for SPL associated-token-account existence (e.g. `BaseAccountClient#splAtaExists`).
- * Must match the `splAta` branch of `TransactionCacheInvalidation` for post-success cache clears.
- */
-export declare const SPL_ATA_CACHE_CATEGORY: "splAta";
-/**
- * Program-agnostic account helpers: shared {@link DataCache} wiring and SPL ATA existence
- * checks for instruction builders (e.g. `getCreateAtaIxIfNeeded`). Extend this in per-program
- * SDKs for typed account fetchers and domain-specific cache categories.
- */
-export declare class BaseAccountClient {
-    protected readonly rpc: Rpc<SolanaRpcApi>;
-    readonly dataCache: DataCache;
-    protected constructor(rpc: Rpc<SolanaRpcApi>, options?: Pick<CacheTtlConfig, "defaultTtlMs" | "categoryTtlMs">);
-    /**
-     * Whether an SPL token account exists at `ata`. Cached under {@link SPL_ATA_CACHE_CATEGORY};
-     * clear via post-success `splAta` transaction cache invalidations after successful creates.
-     */
-    splAtaExists(ata: Address): Promise<boolean>;
-}

package/dist/shared/common/src/services/baseAccountClient.js

@@ -1,38 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseAccountClient = exports.SPL_ATA_CACHE_CATEGORY = void 0;
-const token_1 = require("@solana-program/token");
-const dataCache_1 = require("./dataCache");
-/**
- * DataCache category for SPL associated-token-account existence (e.g. `BaseAccountClient#splAtaExists`).
- * Must match the `splAta` branch of `TransactionCacheInvalidation` for post-success cache clears.
- */
-exports.SPL_ATA_CACHE_CATEGORY = "splAta";
-/** Default TTL for {@link SPL_ATA_CACHE_CATEGORY} entries (SPL token account existence). */
-const DEFAULT_SPL_ATA_TTL_MS = 60000 * 10;
-/**
- * Program-agnostic account helpers: shared {@link DataCache} wiring and SPL ATA existence
- * checks for instruction builders (e.g. `getCreateAtaIxIfNeeded`). Extend this in per-program
- * SDKs for typed account fetchers and domain-specific cache categories.
- */
-class BaseAccountClient {
-    constructor(rpc, options) {
-        this.rpc = rpc;
-        this.dataCache = new dataCache_1.DataCache({
-            defaultTtlMs: options?.defaultTtlMs,
-            categoryTtlMs: {
-                [exports.SPL_ATA_CACHE_CATEGORY]: DEFAULT_SPL_ATA_TTL_MS,
-                ...options?.categoryTtlMs,
-            },
-        });
-    }
-    /**
-     * Whether an SPL token account exists at `ata`. Cached under {@link SPL_ATA_CACHE_CATEGORY};
-     * clear via post-success `splAta` transaction cache invalidations after successful creates.
-     */
-    async splAtaExists(ata) {
-        const { data } = await this.dataCache.getData(async () => (await (0, token_1.fetchMaybeToken)(this.rpc, ata)).exists, exports.SPL_ATA_CACHE_CATEGORY, ata);
-        return data ?? false;
-    }
-}
-exports.BaseAccountClient = BaseAccountClient;

package/dist/shared/common/src/services/baseIxBuilderService.d.ts

@@ -1,27 +0,0 @@
-import type { Address, Instruction } from "@solana/kit";
-import type { TransactionPlan } from "../utils/transaction";
-/**
- * Shared base for SDK instruction/transaction builders.
- *
- * `getIx(args)` is intentionally explicit: callers must provide the fully
- * resolved instruction inputs. Higher-level `getTx()` paths should derive those
- * inputs locally, then call `getIx(args)` without persisting them on the
- * builder instance.
- */
-export declare abstract class BaseIXBuilderService<TContext, TIxArgs, TTxArgs = TIxArgs, TTxResult = TransactionPlan> {
-    protected readonly context: TContext;
-    constructor(context: TContext);
-    abstract getIx(args: TIxArgs): Promise<Instruction>;
-    abstract getTx(args: TTxArgs): Promise<TTxResult>;
-}
-/**
- * Helper for single-instruction builders whose transaction output is a standard
- * `TransactionPlan`.
- */
-export declare abstract class SingleInstructionBuilderService<TContext, TIxArgs, TTxArgs = TIxArgs, TTxPlan extends TransactionPlan = TransactionPlan> extends BaseIXBuilderService<TContext, TIxArgs, TTxArgs, TTxPlan> {
-    protected deriveIxArgs(txArgs: TTxArgs): Promise<TIxArgs>;
-    protected buildPreambleInstructions(_args: TIxArgs, _txArgs: TTxArgs): Promise<Instruction[]>;
-    protected buildLookupTables(_args: TIxArgs, _txArgs: TTxArgs): Promise<readonly Address[] | undefined>;
-    protected buildPlanExtras(_args: TIxArgs, _txArgs: TTxArgs): Promise<Omit<TTxPlan, "instructions" | "lookupTables"> | undefined>;
-    getTx(txArgs: TTxArgs): Promise<TTxPlan>;
-}

package/dist/shared/common/src/services/baseIxBuilderService.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SingleInstructionBuilderService = exports.BaseIXBuilderService = void 0;
-/**
- * Shared base for SDK instruction/transaction builders.
- *
- * `getIx(args)` is intentionally explicit: callers must provide the fully
- * resolved instruction inputs. Higher-level `getTx()` paths should derive those
- * inputs locally, then call `getIx(args)` without persisting them on the
- * builder instance.
- */
-class BaseIXBuilderService {
-    constructor(context) {
-        this.context = context;
-    }
-}
-exports.BaseIXBuilderService = BaseIXBuilderService;
-/**
- * Helper for single-instruction builders whose transaction output is a standard
- * `TransactionPlan`.
- */
-class SingleInstructionBuilderService extends BaseIXBuilderService {
-    async deriveIxArgs(txArgs) {
-        return txArgs;
-    }
-    async buildPreambleInstructions(_args, _txArgs) {
-        return [];
-    }
-    async buildLookupTables(_args, _txArgs) {
-        return undefined;
-    }
-    async buildPlanExtras(_args, _txArgs) {
-        return undefined;
-    }
-    async getTx(txArgs) {
-        const args = await this.deriveIxArgs(txArgs);
-        const preambleInstructions = await this.buildPreambleInstructions(args, txArgs);
-        const instruction = await this.getIx(args);
-        const lookupTables = await this.buildLookupTables(args, txArgs);
-        const extras = await this.buildPlanExtras(args, txArgs);
-        return {
-            instructions: [...preambleInstructions, instruction],
-            ...(lookupTables?.length ? { lookupTables: [...lookupTables] } : {}),
-            ...(extras ?? {}),
-        };
-    }
-}
-exports.SingleInstructionBuilderService = SingleInstructionBuilderService;

package/dist/shared/common/src/services/dataCache.d.ts

@@ -1,41 +0,0 @@
-interface CacheEntry<T> {
-    data: T;
-    timestamp: number;
-}
-export interface CacheTtlConfig {
-    defaultTtlMs?: number;
-    categoryTtlMs?: Record<string, number>;
-}
-export declare class DataCache {
-    protected cache: Map<string, Map<string, CacheEntry<any>>>;
-    protected ttlConfig: CacheTtlConfig;
-    constructor(ttlConfig?: CacheTtlConfig);
-    getData<T>(fetchFn: () => Promise<T | null>, category: string, id: string, options?: {
-        cacheNull?: boolean;
-    }): Promise<{
-        data: T | null;
-        fromCache: boolean;
-    }>;
-    getDataOrThrow<T>(fetchFn: () => Promise<T | null>, category: string, id: string, options?: {
-        cacheNull?: boolean;
-    }): Promise<{
-        data: T;
-        fromCache: boolean;
-    }>;
-    getDataBatch<T>(fetchFn: () => Promise<(T | null)[]>, category: string, ids: string[]): Promise<{
-        data: T[];
-        fromCache: boolean;
-    }>;
-    private getTtlForCategory;
-    protected isStale(entry: CacheEntry<any>, category: string): boolean;
-    /** Returns null if not found or stale */
-    protected tryFromCache<T>(category: string, id: string): T | null;
-    protected getCacheAge(category: string, id: string): number | null;
-    setCache(category: string, id: string, data: any): void;
-    refreshCategory(category: string): void;
-    clearCacheEntry(category: string, id: string): boolean;
-    clearStaleEntries(category: string): number;
-    clearAllStaleEntries(): number;
-    clearAllCache(): void;
-}
-export {};

package/dist/shared/common/src/services/dataCache.js

@@ -1,130 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataCache = void 0;
-class DataCache {
-    constructor(ttlConfig) {
-        this.cache = new Map();
-        this.ttlConfig = {
-            defaultTtlMs: ttlConfig?.defaultTtlMs ?? 60000 * 5, // 5 minute default
-            categoryTtlMs: ttlConfig?.categoryTtlMs ?? {},
-        };
-    }
-    async getData(fetchFn, category, id, options) {
-        let data = this.tryFromCache(category, id);
-        let fromCache = true;
-        if (!data) {
-            data = await fetchFn();
-            if (data !== null || options?.cacheNull !== false) {
-                this.setCache(category, id, data);
-            }
-            fromCache = false;
-        }
-        return { data, fromCache };
-    }
-    async getDataOrThrow(fetchFn, category, id, options) {
-        const { data, fromCache } = await this.getData(fetchFn, category, id, options);
-        if (!data) {
-            throw new Error(`Failed to fetch ${category} data, ID: ${id}`);
-        }
-        return { data, fromCache };
-    }
-    async getDataBatch(fetchFn, category, ids) {
-        let data = ids.map((id) => this.tryFromCache(category, id));
-        let fromCache = true;
-        if (data.some((item) => item === null)) {
-            data = await fetchFn();
-            if (!data) {
-                throw new Error(`Failed to batch fetch ${category} data`);
-            }
-            for (let i = 0; i < ids.length; i++) {
-                this.setCache(category, ids[i], data[i]);
-            }
-            fromCache = false;
-        }
-        return { data: data, fromCache };
-    }
-    getTtlForCategory(category) {
-        return this.ttlConfig.categoryTtlMs?.[category] ?? this.ttlConfig.defaultTtlMs;
-    }
-    isStale(entry, category) {
-        const ttl = this.getTtlForCategory(category);
-        const age = Date.now() - entry.timestamp;
-        return age > ttl;
-    }
-    /** Returns null if not found or stale */
-    tryFromCache(category, id) {
-        const categoryCache = this.cache.get(category);
-        if (!categoryCache) {
-            return null;
-        }
-        const entry = categoryCache.get(id);
-        if (!entry) {
-            return null;
-        }
-        if (this.isStale(entry, category)) {
-            categoryCache.delete(id);
-            return null;
-        }
-        return entry.data;
-    }
-    getCacheAge(category, id) {
-        const categoryCache = this.cache.get(category);
-        if (!categoryCache) {
-            return null;
-        }
-        const entry = categoryCache.get(id);
-        if (!entry) {
-            return null;
-        }
-        return Date.now() - entry.timestamp;
-    }
-    setCache(category, id, data) {
-        let categoryCache = this.cache.get(category);
-        if (!categoryCache) {
-            categoryCache = new Map();
-            this.cache.set(category, categoryCache);
-        }
-        categoryCache.set(id, {
-            data,
-            timestamp: Date.now(),
-        });
-    }
-    refreshCategory(category) {
-        const categoryCache = this.cache.get(category);
-        if (categoryCache) {
-            categoryCache.clear();
-        }
-    }
-    clearCacheEntry(category, id) {
-        const categoryCache = this.cache.get(category);
-        if (!categoryCache) {
-            return false;
-        }
-        return categoryCache.delete(id);
-    }
-    clearStaleEntries(category) {
-        const categoryCache = this.cache.get(category);
-        if (!categoryCache) {
-            return 0;
-        }
-        let cleared = 0;
-        for (const [id, entry] of categoryCache.entries()) {
-            if (this.isStale(entry, category)) {
-                categoryCache.delete(id);
-                cleared++;
-            }
-        }
-        return cleared;
-    }
-    clearAllStaleEntries() {
-        let totalCleared = 0;
-        for (const category of this.cache.keys()) {
-            totalCleared += this.clearStaleEntries(category);
-        }
-        return totalCleared;
-    }
-    clearAllCache() {
-        this.cache.clear();
-    }
-}
-exports.DataCache = DataCache;

package/dist/shared/common/src/services/index.d.ts

@@ -1,8 +0,0 @@
-export * from "./baseAccountClient";
-export * from "./baseIxBuilderService";
-export * from "./dataCache";
-export * from "./lutManager";
-export * from "./mints";
-export * from "./swap";
-export * from "./token";
-export * from "./transactionSender";