@kestrelfi/lyc-sdk 1.0.1 → 1.0.3

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

@@ -1,10 +0,0 @@
-export * from "./errors";
-export * from "./utils";
-export * from "./constants";
-export * from "./client";
-export * from "./services";
-export * from "./models";
-export * from "./types";
-export * from "./metrics";
-export * from "./decoders";
-export type { ResolvedDecreaseCarryCpiPlan } from "./utils";

package/dist/sdks/long-yield-carry/src/index.js

@@ -1,25 +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("./errors"), exports);
-__exportStar(require("./utils"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./client"), exports);
-__exportStar(require("./services"), exports);
-__exportStar(require("./models"), exports);
-__exportStar(require("./types"), exports);
-__exportStar(require("./metrics"), exports);
-__exportStar(require("./decoders"), exports);

package/dist/sdks/long-yield-carry/src/metrics/index.d.ts

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

package/dist/sdks/long-yield-carry/src/metrics/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("./protocolMetrics"), exports);

package/dist/sdks/long-yield-carry/src/metrics/protocolMetrics.d.ts

@@ -1,276 +0,0 @@
-import type { Address } from "@solana/kit";
-import { LendingPlatform } from "common";
-import type { LendingPositionInspectMetrics, ReserveBase } from "lending-platforms";
-import type { LongYieldCarryClient } from "../client";
-import type { LYCToken, TokenLendingPositionData } from "../models/lycToken";
-import type { LYCYieldingBank } from "../models/yieldingBank";
-import { type FeeDripAbsorptionStatus } from "../utils/feeDripMetrics";
-/** Skip dust Kamino slots when a material position exists on the same token. */
-export declare const MIN_MATERIAL_KAMINO_COLLATERAL_USD = 1;
-export interface LendingPositionInspectMetricSnapshot {
-    utilizationRealtimeBps: number;
-    utilizationEmaBps: number;
-    lowerTriggerPriceChangePct?: number;
-    upperTriggerPriceChangePct?: number;
-}
-export interface YieldingBankExternalPositionMetricSnapshot {
-    platform: LendingPlatform;
-    pool: Address;
-    tvlUsdRaw: string;
-    tvlUsd: number;
-}
-export type ProtocolMetricEntityType = "token" | "yielding_bank" | "yielding_bank_asset" | "kamino_position_rate" | "token_lending_position" | "token_carry_position" | "fee_wallet_balance" | "protocol_manifest";
-/**
- * Balance held by the protocol fee wallet for one mint. Performance fees
- * arrive here as collateral at `collect_interest` time (no pending counter
- * exists on the token), and mint/burn fees arrive as yTokens via
- * `collect_fees` — so these balances are the only on-chain record of
- * cumulative collected fees.
- */
-export interface FeeWalletBalanceMetricSnapshot {
-    entityType: "fee_wallet_balance";
-    wallet: Address;
-    mint: Address;
-    symbol: string;
-    /** "collateral" = performance fees; "ytoken" = collected mint/burn fees. */
-    kind: "collateral" | "ytoken";
-    decimals: number;
-    amountRaw: string;
-    amountUi: number;
-    priceUsd: number;
-    valueUsd: number;
-}
-/** Index of entity keys written for a single ingestion hour (enables API assembly). */
-export interface ProtocolManifestSnapshot {
-    entityType: "protocol_manifest";
-    tokenMints: Address[];
-    bankAddresses: Address[];
-    kaminoPositions: Array<{
-        mint: Address;
-        lendingPositionIndex: number;
-    }>;
-    yieldingBankAssets: Array<{
-        bank: Address;
-        mint: Address;
-    }>;
-    /** Present on manifests written after Phase 2 ingestion deploy. */
-    tokenLendingPositions?: Array<{
-        mint: Address;
-        lendingPositionIndex: number;
-    }>;
-    /** Present on manifests written after Phase 2 ingestion deploy. */
-    tokenCarryPositions?: Array<{
-        mint: Address;
-        carryPositionIndex: number;
-    }>;
-    /** Present on manifests written after fee-wallet tracking deploy. */
-    feeWalletBalances?: Array<{
-        wallet: Address;
-        mint: Address;
-    }>;
-    /**
-     * Per-row build failures from this ingestion hour (skipped Kamino rate rows,
-     * failed inspect enrichment). Persisted so the ops dashboard can surface
-     * partial snapshots instead of silently dropping rows.
-     */
-    errors?: ProtocolMetricsSnapshotError[];
-}
-export declare const PROTOCOL_MANIFEST_PK = "protocol_manifest";
-export interface TokenMetricSnapshot {
-    entityType: "token";
-    token: Address;
-    mint: Address;
-    collateralMint: Address;
-    isActive: boolean;
-    priceCollateral: number;
-    collateralPriceUsd: number;
-    priceUsd: number;
-    totalSupply: number;
-    tvlUsdRaw: string;
-    tvlUsd: number;
-    carryTvlUsdRaw: string;
-    carryTvlUsd: number;
-    debtUsdRaw: string;
-    debtUsd: number;
-    netYieldUsdRaw: string;
-    netYieldUsd: number;
-    pendingProtocolFeesRaw: string;
-    pendingProtocolFeesUi: number;
-    pendingCuratorFeesRaw: string;
-    pendingCuratorFeesUi: number;
-    performanceFeeBps: number;
-    mintingFeeBps: number;
-    burningFeeBps: number;
-    protocolMintBurnPctBps: number;
-    curatorMintBurnPctBps: number;
-    curatorPerfPctBps: number;
-    /** Absent on snapshots ingested before fee-drip projection metrics were added. */
-    feeDripMaxApyBps?: number;
-    feeDripCurrentApyBps?: number | null;
-    undrippedFeeCollateralUi?: number;
-    feeDripAbsorptionEtaSeconds?: number | null;
-    feeDripAbsorptionStatus?: FeeDripAbsorptionStatus;
-    firstMintTs: number;
-    collateralOracle: Address;
-    collateralLastRefreshedTs: number;
-    unlentCollateralUi: number;
-    lastRefreshedTs: number;
-}
-export interface YieldingBankMetricSnapshot {
-    entityType: "yielding_bank";
-    bank: Address;
-    id: number;
-    baseMint: Address;
-    isActive: boolean;
-    sharePriceRaw: string;
-    sharePriceUsd: number;
-    totalSharesRaw: string;
-    totalShares: number;
-    tvlUsdRaw: string;
-    tvlUsd: number;
-    baseSymbol: string;
-    curator: Address;
-    circuitBreaker: number;
-    defaultRedemptionMint?: Address;
-    externalYieldingPositions: YieldingBankExternalPositionMetricSnapshot[];
-    lastRefreshedTs: number;
-    lastRebalancedTs: number;
-}
-export interface YieldingBankAssetMetricSnapshot {
-    entityType: "yielding_bank_asset";
-    bank: Address;
-    assetIndex: number;
-    assetKind: "base" | "asset";
-    mint: Address;
-    amountRaw: string;
-    amountUi: number;
-    decimals: number;
-    priceRaw: string;
-    priceUsd: number;
-    tvlUsdRaw: string;
-    tvlUsd: number;
-}
-export interface TokenLendingPositionMetricSnapshot {
-    entityType: "token_lending_position";
-    token: Address;
-    mint: Address;
-    lendingPositionIndex: number;
-    platform: LendingPlatform;
-    withdrawPending: boolean;
-    pool: Address;
-    userAccount: Address;
-    collateralAmountRaw: string;
-    collateralAmountUi: number;
-    collateralSymbol: string;
-    collateralUsd: number;
-    debtAmountRaw: string;
-    debtAmountUi: number;
-    debtTvlUsdRaw: string;
-    debtTvlUsd: number;
-    debtMint: Address;
-    debtSymbol: string;
-    debtPriceUsd: number;
-    onChainUtilizationRateBps: number;
-    targetUtilizationRateBps: number;
-    maxDeviationAboveTargetUtilBps: number;
-    maxDeviationBelowTargetUtilBps: number;
-    inspect?: LendingPositionInspectMetricSnapshot;
-}
-export interface TokenCarryPositionMetricSnapshot {
-    entityType: "token_carry_position";
-    token: Address;
-    mint: Address;
-    carryPositionIndex: number;
-    yieldingBankId: number;
-    yieldingBankAddress?: Address;
-    baseMint: Address;
-    baseSymbol: string;
-    sharesRaw: string;
-    sharesUi?: number;
-    tvlUsdRaw: string;
-    tvlUsd: number;
-}
-export interface KaminoPositionRateSnapshot {
-    entityType: "kamino_position_rate";
-    token: Address;
-    mint: Address;
-    lendingPositionIndex: number;
-    pool: Address;
-    userAccount: Address;
-    collateralReserve: Address;
-    debtReserve: Address;
-    collateralMint: Address;
-    debtMint: Address;
-    supplyBaseApy: number;
-    borrowBaseApy: number;
-    supplyEffectiveApy: number;
-    borrowEffectiveApy: number;
-    netEffectiveApy: number;
-    collateralReserveUtilizationPct: number;
-    debtReserveUtilizationPct: number;
-    onChainLtvUtilizationBps: number;
-    targetUtilizationRateBps: number;
-    maxDeviationAboveTargetUtilBps: number;
-    maxDeviationBelowTargetUtilBps: number;
-}
-export type ProtocolMetricSnapshotRow = TokenMetricSnapshot | YieldingBankMetricSnapshot | YieldingBankAssetMetricSnapshot | KaminoPositionRateSnapshot | TokenLendingPositionMetricSnapshot | TokenCarryPositionMetricSnapshot | FeeWalletBalanceMetricSnapshot | ProtocolManifestSnapshot;
-export interface ProtocolMetricsSnapshot {
-    timestamp: number;
-    tokens: TokenMetricSnapshot[];
-    yieldingBanks: YieldingBankMetricSnapshot[];
-    yieldingBankAssets: YieldingBankAssetMetricSnapshot[];
-    kaminoPositionRates: KaminoPositionRateSnapshot[];
-    tokenLendingPositions: TokenLendingPositionMetricSnapshot[];
-    tokenCarryPositions: TokenCarryPositionMetricSnapshot[];
-    feeWalletBalances: FeeWalletBalanceMetricSnapshot[];
-    errors: ProtocolMetricsSnapshotError[];
-}
-export interface ProtocolMetricsSnapshotError {
-    scope: "kamino_position_rate" | "lending_position_inspect";
-    token: Address;
-    lendingPositionIndex: number;
-    message: string;
-}
-export interface BuildProtocolMetricsSnapshotOptions {
-    timestamp?: number;
-    includeInactive?: boolean;
-    tokens?: LYCToken[];
-    yieldingBanks?: LYCYieldingBank[];
-}
-export declare function protocolMetricPartitionKey(metric: ProtocolMetricSnapshotRow): string;
-export declare function buildProtocolManifestSnapshot(snapshot: ProtocolMetricsSnapshot): ProtocolManifestSnapshot;
-export declare function flattenProtocolMetricsSnapshot(snapshot: ProtocolMetricsSnapshot): ProtocolMetricSnapshotRow[];
-/** Dynamo item shape written by {@link buildProtocolMetricDynamoItems}. */
-export interface ProtocolMetricDynamoItem {
-    pk: string;
-    timestamp: number;
-    entityType: ProtocolMetricEntityType;
-    metrics: ProtocolMetricSnapshotRow;
-    ttl?: number;
-}
-export declare function toProtocolMetricDynamoItem(metric: ProtocolMetricSnapshotRow, hourTimestamp: number, ttl?: number): ProtocolMetricDynamoItem;
-export interface BuildProtocolMetricDynamoItemsOptions extends BuildProtocolMetricsSnapshotOptions {
-    hourTimestamp: number;
-    ttl?: number;
-}
-export interface BuildProtocolMetricDynamoItemsResult {
-    items: ProtocolMetricDynamoItem[];
-    errors: ProtocolMetricsSnapshotError[];
-}
-/** Builds on-chain snapshot rows and maps them to Dynamo put payloads. */
-export declare function buildProtocolMetricDynamoItems(client: LongYieldCarryClient, opts: BuildProtocolMetricDynamoItemsOptions): Promise<BuildProtocolMetricDynamoItemsResult>;
-export declare function buildProtocolMetricsSnapshot(client: LongYieldCarryClient, opts?: BuildProtocolMetricsSnapshotOptions): Promise<ProtocolMetricsSnapshot>;
-export declare function buildFeeWalletBalanceSnapshots(client: LongYieldCarryClient, tokens: LYCToken[]): Promise<FeeWalletBalanceMetricSnapshot[]>;
-export declare function buildTokenMetricSnapshot(token: LYCToken, yieldingBanks?: LYCYieldingBank[], nowTs?: number): TokenMetricSnapshot;
-export declare function buildYieldingBankMetricSnapshot(bank: LYCYieldingBank): YieldingBankMetricSnapshot;
-export declare function buildTokenLendingPositionMetricSnapshots(token: LYCToken, yieldingBanks?: LYCYieldingBank[]): TokenLendingPositionMetricSnapshot[];
-export declare function buildTokenLendingPositionMetricSnapshotsAsync(client: LongYieldCarryClient, token: LYCToken, yieldingBanks?: LYCYieldingBank[]): Promise<{
-    snapshots: TokenLendingPositionMetricSnapshot[];
-    errors: ProtocolMetricsSnapshotError[];
-}>;
-export declare function serializeLendingPositionInspectMetrics(metrics: LendingPositionInspectMetrics | null | undefined): LendingPositionInspectMetricSnapshot | undefined;
-export declare function kaminoCollateralUsd(token: LYCToken, position: TokenLendingPositionData): number;
-export declare function shouldIncludeKaminoPositionRate(collateralUsd: number, maxCollateralUsdOnToken: number): boolean;
-export declare function buildTokenCarryPositionMetricSnapshots(token: LYCToken, yieldingBanks: LYCYieldingBank[]): TokenCarryPositionMetricSnapshot[];
-export declare function buildYieldingBankAssetMetricSnapshots(bank: LYCYieldingBank): YieldingBankAssetMetricSnapshot[];
-export declare function buildKaminoPositionRateSnapshotFromReserves(token: LYCToken, lendingPositionIndex: number, position: TokenLendingPositionData, collateralReserve: ReserveBase, debtReserve: ReserveBase): KaminoPositionRateSnapshot;