@xoxno/types 1.0.429 → 1.0.431

package/dist/stellar-lending/documents/index.d.ts

@@ -4,6 +4,5 @@ export * from './hub-asset.doc';
 export * from './spoke.doc';
 export * from './spoke-asset.doc';
 export * from './account-position.doc';
-export * from './top-holders.doc';
 export * from './governance-proposal.doc';
 export * from './cursor.doc';

package/dist/stellar-lending/documents/index.js

@@ -20,6 +20,5 @@ __exportStar(require("./hub-asset.doc"), exports);
 __exportStar(require("./spoke.doc"), exports);
 __exportStar(require("./spoke-asset.doc"), exports);
 __exportStar(require("./account-position.doc"), exports);
-__exportStar(require("./top-holders.doc"), exports);
 __exportStar(require("./governance-proposal.doc"), exports);
 __exportStar(require("./cursor.doc"), exports);

package/dist/stellar-lending/enums/data-type.enum.d.ts

@@ -5,7 +5,6 @@ export declare enum StellarLendingDataType {
     SPOKE = "spoke",
     SPOKE_ASSET = "spokeAsset",
     ACCOUNT_POSITION = "accountPosition",
-    TOP_HOLDERS = "topHolders",
     GOVERNANCE_PROPOSAL = "governanceProposal",
     CURSOR = "cursor"
 }

package/dist/stellar-lending/enums/data-type.enum.js

@@ -9,7 +9,6 @@ var StellarLendingDataType;
     StellarLendingDataType["SPOKE"] = "spoke";
     StellarLendingDataType["SPOKE_ASSET"] = "spokeAsset";
     StellarLendingDataType["ACCOUNT_POSITION"] = "accountPosition";
-    StellarLendingDataType["TOP_HOLDERS"] = "topHolders";
     StellarLendingDataType["GOVERNANCE_PROPOSAL"] = "governanceProposal";
     StellarLendingDataType["CURSOR"] = "cursor";
 })(StellarLendingDataType || (exports.StellarLendingDataType = StellarLendingDataType = {}));

package/dist/stellar-lending/kusto/activity-data.d.ts

@@ -12,9 +12,40 @@ export interface StellarLendingActivityData {
     accountId: string | null;
     owner: string | null;
     token: string;
+    /** Action delta amount (this tx), big-int string. */
     amount: string;
     amountShort: number;
     oraclePrice: number | null;
     usd: number | null;
     feeShort?: number;
+    /**
+     * Which side of the position this row mutated (`null` for non-position
+     * events: flash loan, strategy fee, bad-debt header).
+     */
+    side: 'supply' | 'borrow' | null;
+    /**
+     * Position's RESULTING scaled balance (27-dec RAY) on `side` AFTER the
+     * action — `'0'` when the position is closed. `null` for non-position events.
+     * Source of truth for current/historical holders via `arg_max(seq)`.
+     */
+    balanceScaledRay: string | null;
+    /**
+     * Denominated resulting balance (display units) — numeric so Kusto can rank
+     * holders directly (within a reserve, amount order == scaled order). `null`
+     * for non-position events.
+     */
+    balanceShort: number | null;
+    /**
+     * Monotonic event ordinal `ledger * 1e6 + indexInLedger`, derived from the
+     * Soroban `getEvents` id `"<ledger>-<index>"`. Use as the `arg_max` key to
+     * pick each holder's latest balance deterministically.
+     */
+    seq: number;
+    /**
+     * Pool index (27-dec RAY) on `side` at event time — supply index for supply
+     * legs, borrow index for borrow legs. With `balanceShort` (scaled, denominated)
+     * the actual balance is `balanceShort * index / 1e27`; interval growth across
+     * events yields realized PnL. `null` for non-position events.
+     */
+    index: string | null;
 }

package/dist/stellar-lending/kusto/index.d.ts

@@ -1,2 +1,2 @@
 export * from './activity-data';
-export * from './market-snapshot-row';
+export * from './market-state-data';

package/dist/stellar-lending/kusto/index.js

@@ -15,4 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./activity-data"), exports);
-__exportStar(require("./market-snapshot-row"), exports);
+__exportStar(require("./market-state-data"), exports);

package/dist/stellar-lending/kusto/market-state-data.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ActivityType for Stellar-lending market-state activity rows. Deliberately
+ * DISTINCT from the MVX `lendingUpdateMarketState` so the existing MVX Kusto
+ * update policies (which filter only on `Source=='xoxnoLending'`) never ingest
+ * Stellar rows. The new Stellar Kusto functions filter on this + `Chain=='STELLAR'`.
+ */
+export declare const STELLAR_LENDING_MARKET_STATE_ACTIVITY = "stellarLendingUpdateMarketState";
+/**
+ * Dynamic JSON written into `NftActivityData.ActivityData` for a Stellar
+ * market-state update (emitted on every `market:batch_state_update`). One row
+ * per `(hub, asset)`; carries the point-in-time market metrics + price so all
+ * market time-series (TVL, APY, utilization, protocol revenue) are derived
+ * on-the-fly via Kusto — no snapshot table.
+ *
+ * Amounts are ACTUAL token units, denominated (display numbers); `*Ray` are
+ * 27-dec RAY big-int strings.
+ */
+export interface StellarLendingMarketStateData {
+    hubId: number;
+    spokeId: number | null;
+    token: string;
+    symbol: string;
+    decimals: number;
+    supplyAmount: number;
+    borrowAmount: number;
+    availableLiquidity: number;
+    revenue: number;
+    supplyApy: number;
+    borrowApy: number;
+    utilizationRate: number;
+    supplyIndexRay: string;
+    borrowIndexRay: string;
+    oraclePrice: number | null;
+    seq: number;
+}

package/dist/stellar-lending/kusto/market-state-data.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STELLAR_LENDING_MARKET_STATE_ACTIVITY = void 0;
+/**
+ * ActivityType for Stellar-lending market-state activity rows. Deliberately
+ * DISTINCT from the MVX `lendingUpdateMarketState` so the existing MVX Kusto
+ * update policies (which filter only on `Source=='xoxnoLending'`) never ingest
+ * Stellar rows. The new Stellar Kusto functions filter on this + `Chain=='STELLAR'`.
+ */
+exports.STELLAR_LENDING_MARKET_STATE_ACTIVITY = 'stellarLendingUpdateMarketState';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xoxno/types",
-  "version": "1.0.429",
+  "version": "1.0.431",
   "description": "Shared types and utilities for XOXNO API.",
   "exports": {
     ".": {

package/dist/stellar-lending/documents/top-holders.doc.d.ts

@@ -1,22 +0,0 @@
-import { StellarLendingDataType } from '../enums';
-export interface StellarTopHolder {
-    owner: string;
-    accountId: string;
-    scaledRay: string;
-    amountShort: number;
-    sharePct: number;
-}
-export declare class StellarTopHoldersDoc {
-    dataType: StellarLendingDataType;
-    spokeId: number;
-    hubId: number;
-    asset: string;
-    side: 'deposits' | 'borrows';
-    totalScaledRay: string;
-    holders: StellarTopHolder[];
-    updatedAt: number;
-    id: string;
-    pk: string;
-    _ts?: number;
-    constructor(props?: Partial<StellarTopHoldersDoc>);
-}

package/dist/stellar-lending/documents/top-holders.doc.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StellarTopHoldersDoc = void 0;
-const enums_1 = require("../enums");
-class StellarTopHoldersDoc {
-    constructor(props) {
-        this.dataType = enums_1.StellarLendingDataType.TOP_HOLDERS;
-        this.totalScaledRay = '0';
-        this.holders = [];
-        this.updatedAt = 0;
-        Object.assign(this, props);
-        this.pk = this.dataType;
-        this.id = `topHolders:${this.spokeId}:${this.hubId}:${this.asset}:${this.side}`;
-    }
-}
-exports.StellarTopHoldersDoc = StellarTopHoldersDoc;

package/dist/stellar-lending/kusto/market-snapshot-row.d.ts

@@ -1,25 +0,0 @@
-/**
- * One row of the Kusto `StellarLendingMarketSnapshot` table, written by the
- * hub-aware snapshot cron. `SpokeId` is null for hub/asset-scoped rows and set
- * for spoke/reserve-scoped rows.
- */
-export interface StellarLendingMarketSnapshotRow {
-    SnapshotAt: string;
-    Chain: 'STELLAR';
-    HubId: number;
-    SpokeId: number | null;
-    Token: string;
-    Symbol: string;
-    Decimals: number;
-    UsdPrice: number;
-    SupplyApy: number;
-    BorrowApy: number;
-    Utilization: number;
-    TotalDepositsRaw: string;
-    TotalDepositsUsd: number;
-    TotalBorrowsRaw: string;
-    TotalBorrowsUsd: number;
-    AvailableLiquidityUsd: number;
-    SupplyIndexRay: string;
-    BorrowIndexRay: string;
-}

package/dist/stellar-lending/kusto/market-snapshot-row.js

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