@kestrelfi/lyc-sdk 1.0.1

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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,25 @@
+"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

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

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

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

@@ -0,0 +1,276 @@
+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;