@xoxno/types 1.0.484 → 1.0.486

package/dist/requests/lending/stellar-lending-events.dto.d.ts

@@ -69,6 +69,21 @@ export declare class StellarUpdateMarketParamsBatchEvent {
 export declare class StellarUpdateMarketStateBatchEvent {
     updates: StellarMarketStateSnapshot[];
 }
+/**
+ * One account's net position deltas for a transaction.
+ *
+ * A transaction may emit MORE THAN ONE of these. A share-credit liquidation
+ * (`SeizeMode::Credit`) emits exactly two — the liquidated account first, then
+ * the liquidator's receiving account — and both precede any `debt:bad_debt`.
+ * A transfer-mode liquidation emits exactly one. Consumers must key on
+ * `accountId` per event rather than assuming one batch per transaction.
+ *
+ * The receiver's batch is supply-side only and omits any leg whose net credit
+ * rounds to zero. It is also the ONLY announcement of a `Credit(0)`-created
+ * account: there is no account-creation event, so an indexer that discovers
+ * accounts from a creation event alone will never see it — take the identity
+ * from `accountAttributes`.
+ */
 export declare class StellarUpdatePositionBatchEvent {
     accountId: string;
     accountAttributes: StellarEventAccountAttributes;

package/dist/requests/lending/stellar-lending-events.dto.js

@@ -314,6 +314,21 @@ __decorate([
     __metadata("design:type", Array)
 ], StellarUpdateMarketStateBatchEvent.prototype, "updates", void 0);
 // ---------- topic: position:batch_update ----------
+/**
+ * One account's net position deltas for a transaction.
+ *
+ * A transaction may emit MORE THAN ONE of these. A share-credit liquidation
+ * (`SeizeMode::Credit`) emits exactly two — the liquidated account first, then
+ * the liquidator's receiving account — and both precede any `debt:bad_debt`.
+ * A transfer-mode liquidation emits exactly one. Consumers must key on
+ * `accountId` per event rather than assuming one batch per transaction.
+ *
+ * The receiver's batch is supply-side only and omits any leg whose net credit
+ * rounds to zero. It is also the ONLY announcement of a `Credit(0)`-created
+ * account: there is no account-creation event, so an indexer that discovers
+ * accounts from a creation event alone will never see it — take the identity
+ * from `accountAttributes`.
+ */
 class StellarUpdatePositionBatchEvent {
 }
 exports.StellarUpdatePositionBatchEvent = StellarUpdatePositionBatchEvent;
@@ -616,13 +631,13 @@ __decorate([
 ], StellarLiquidationEvent.prototype, "accountId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Aggregate debt repaid, USD WAD decimal string',
+        description: 'Aggregate debt actually repaid, USD WAD decimal string. Measured receipt — net of refunds and of any shortfall from an under-delivering debt token — so it agrees with the LiqRepay legs of the position batch, not with the liquidator requested payment',
     }),
     __metadata("design:type", String)
 ], StellarLiquidationEvent.prototype, "repaidUsdWad", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Applied liquidation bonus, bps decimal string; total seized USD is repaid * (1 + bonus)',
+        description: 'Applied liquidation bonus, bps decimal string; gross seized USD is repaid * (1 + bonus), with the protocol fee still inside that figure',
     }),
     __metadata("design:type", String)
 ], StellarLiquidationEvent.prototype, "bonusBps", void 0);

package/dist/stellar-lending/context.d.ts

@@ -50,6 +50,13 @@ export interface StellarReserveDetailItem {
     isBorrowable: boolean;
     paused: boolean;
     frozen: boolean;
+    /**
+     * Spoke-asset `no_seize`: the reserve cannot be taken as liquidation
+     * collateral. Gates only the seizure leg — supply/borrow/withdraw/repay stay
+     * open, so a liquidator must exclude this reserve from expected proceeds or
+     * the call reverts (`SpokeError::SpokeAssetSeizureHalted`).
+     */
+    noSeize: boolean;
     useAsCollateral: boolean;
     targetHealthFactorWad: string;
     healthFactorForMaxBonusWad: string;

package/dist/stellar-lending/documents/cursor.doc.d.ts

@@ -20,6 +20,12 @@ export declare class StellarLendingCursorDoc {
     poolAddress: string | null;
     priceAggregatorAddress: string | null;
     governanceAddress: string | null;
+    /**
+     * Position-NFT contract bound to this cursor position. NFT transfers change
+     * account ownership without any controller event, so the indexer watches it;
+     * a repoint invalidates the cursor like every other watched address.
+     */
+    positionNftAddress: string | null;
     /**
      * Decode-logic version. Bumping it discards the cursor and replays everything
      * within RPC retention, so a decoder fix reaches already-indexed events.

package/dist/stellar-lending/documents/cursor.doc.js

@@ -23,6 +23,12 @@ class StellarLendingCursorDoc {
         this.poolAddress = null;
         this.priceAggregatorAddress = null;
         this.governanceAddress = null;
+        /**
+         * Position-NFT contract bound to this cursor position. NFT transfers change
+         * account ownership without any controller event, so the indexer watches it;
+         * a repoint invalidates the cursor like every other watched address.
+         */
+        this.positionNftAddress = null;
         /**
          * Decode-logic version. Bumping it discards the cursor and replays everything
          * within RPC retention, so a decoder fix reaches already-indexed events.

package/dist/stellar-lending/documents/spoke-asset.doc.d.ts

@@ -17,6 +17,14 @@ export declare class StellarSpokeAssetDoc {
     isBorrowable: boolean;
     paused: boolean;
     frozen: boolean;
+    /**
+     * On-chain `SpokeAssetConfig.no_seize`. Gates ONLY the liquidation seizure
+     * leg — the asset stays fully usable for supply/borrow/withdraw/repay.
+     * Independent of `paused` (blocks every user verb) and `frozen` (blocks new
+     * exposure, permits exits); seizure is deliberately not gated by `paused`
+     * because it is pro-rata across the whole collateral set.
+     */
+    noSeize: boolean;
     loanToValueBps: number;
     liquidationThresholdBps: number;
     liquidationBonusBps: number;

package/dist/stellar-lending/documents/spoke-asset.doc.js

@@ -17,6 +17,14 @@ class StellarSpokeAssetDoc {
         this.isBorrowable = false;
         this.paused = false;
         this.frozen = false;
+        /**
+         * On-chain `SpokeAssetConfig.no_seize`. Gates ONLY the liquidation seizure
+         * leg — the asset stays fully usable for supply/borrow/withdraw/repay.
+         * Independent of `paused` (blocks every user verb) and `frozen` (blocks new
+         * exposure, permits exits); seizure is deliberately not gated by `paused`
+         * because it is pro-rata across the whole collateral set.
+         */
+        this.noSeize = false;
         this.loanToValueBps = 0;
         this.liquidationThresholdBps = 0;
         this.liquidationBonusBps = 0;

package/dist/stellar-lending/enums/activity.enum.d.ts

@@ -13,6 +13,26 @@ export declare enum StellarLendingActivity {
     RepayWithCollateral = "repayWithCollateral",
     CloseWithdraw = "closeWithdraw",
     Migrate = "migrate",
+    /**
+     * On-chain `PositionAction::LiqCredit` (15) — the collateral credited to a
+     * share-credit liquidator's receiving account. Emitted only under
+     * `SeizeMode::Credit`, on the second (receiver) position batch.
+     *
+     * Gross vs net, and the reason this is a separate tag from `LiqSeize`:
+     * `liqSeize` is the liquidated account's debit, **gross** of the protocol fee
+     * (in both seize modes); `liqCredit` is the receiver's credit, **net** of it.
+     * The fee is `liqSeize.amount - liqCredit.amount`. Summing both tags as one
+     * quantity double-counts the seizure, and reading the gross `liqSeize` figure
+     * as liquidator proceeds overstates them by the fee.
+     */
+    LiqCredit = "liqCredit",
+    /**
+     * Position-NFT `transfer` — the whole account (collateral AND debt) changed
+     * hands outside the controller. `owner` is the receiving wallet; the row's
+     * address is the sender. Not an on-chain `PositionAction`: emitted by the
+     * position-NFT contract, not the controller.
+     */
+    NftTransfer = "nftTransfer",
     FlashLoan = "flashLoan",
     BadDebt = "badDebt",
     StrategyFee = "strategyFee",

package/dist/stellar-lending/enums/activity.enum.js

@@ -17,6 +17,26 @@ var StellarLendingActivity;
     StellarLendingActivity["RepayWithCollateral"] = "repayWithCollateral";
     StellarLendingActivity["CloseWithdraw"] = "closeWithdraw";
     StellarLendingActivity["Migrate"] = "migrate";
+    /**
+     * On-chain `PositionAction::LiqCredit` (15) — the collateral credited to a
+     * share-credit liquidator's receiving account. Emitted only under
+     * `SeizeMode::Credit`, on the second (receiver) position batch.
+     *
+     * Gross vs net, and the reason this is a separate tag from `LiqSeize`:
+     * `liqSeize` is the liquidated account's debit, **gross** of the protocol fee
+     * (in both seize modes); `liqCredit` is the receiver's credit, **net** of it.
+     * The fee is `liqSeize.amount - liqCredit.amount`. Summing both tags as one
+     * quantity double-counts the seizure, and reading the gross `liqSeize` figure
+     * as liquidator proceeds overstates them by the fee.
+     */
+    StellarLendingActivity["LiqCredit"] = "liqCredit";
+    /**
+     * Position-NFT `transfer` — the whole account (collateral AND debt) changed
+     * hands outside the controller. `owner` is the receiving wallet; the row's
+     * address is the sender. Not an on-chain `PositionAction`: emitted by the
+     * position-NFT contract, not the controller.
+     */
+    StellarLendingActivity["NftTransfer"] = "nftTransfer";
     StellarLendingActivity["FlashLoan"] = "flashLoan";
     StellarLendingActivity["BadDebt"] = "badDebt";
     StellarLendingActivity["StrategyFee"] = "strategyFee";

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

@@ -14,7 +14,14 @@ export interface StellarLendingActivityData {
     accountId: string | null;
     owner: string | null;
     token: string;
-    /** Action delta amount (this tx), big-int string. */
+    /**
+     * Action delta amount (this tx), big-int string.
+     *
+     * Liquidation caveat: a share-credit liquidation emits BOTH a `liqSeize` leg
+     * on the liquidated account (gross of the protocol fee) and a `liqCredit` leg
+     * on the receiving account (net of it) for the same seizure. Summing the two
+     * tags double-counts it — pick one side per query.
+     */
     amount: string;
     /**
      * Display-unit delta. `null` when the asset header decimals are not yet
@@ -77,21 +84,32 @@ export interface StellarLendingActivityData {
     loanToValueBps: number | null;
     liquidationFeesBps: number | null;
     /**
-     * Liquidator (caller) address on liquidation legs (`liqRepay`/`liqSeize`),
-     * correlated by tx from the on-chain `LiquidationEvent`. `null` on all other
-     * rows. Enables a top-liquidators leaderboard (the legs' `accountId`/`owner`
-     * are the liquidatee).
+     * Liquidator (caller) address on liquidation legs
+     * (`liqRepay`/`liqSeize`/`liqCredit`), correlated by tx from the on-chain
+     * `LiquidationEvent`. `null` on all other rows. Enables a top-liquidators
+     * leaderboard.
+     *
+     * Whose account the leg belongs to differs by tag: on `liqRepay`/`liqSeize`
+     * the `accountId`/`owner` are the liquidatee, on `liqCredit` they are the
+     * liquidator's own receiving account (share-credit mode). Do not treat
+     * `owner` as the liquidatee without filtering the tag.
      */
     liquidator: string | null;
     /**
      * Aggregate debt repaid (USD WAD string) from `position:liquidation`, stamped
-     * onto same-tx `liqRepay`/`liqSeize` legs. `null` on non-liquidation rows.
+     * onto same-tx `liqRepay`/`liqSeize`/`liqCredit` legs. `null` on
+     * non-liquidation rows.
+     *
+     * This is the MEASURED receipt — net of refunds and of any shortfall from an
+     * under-delivering debt token — so it agrees with the `liqRepay` legs, not
+     * with the liquidator's requested payment.
      */
     repaidUsdWad?: string | null;
     /**
      * Applied liquidation bonus (bps string) from `position:liquidation`, stamped
-     * onto same-tx `liqRepay`/`liqSeize` legs. Total seized USD ≈
-     * repaid * (1 + bonus / 10_000). `null` on non-liquidation rows.
+     * onto same-tx `liqRepay`/`liqSeize`/`liqCredit` legs. Gross seized USD ≈
+     * repaid * (1 + bonus / 10_000) — the protocol fee is still inside that
+     * figure. `null` on non-liquidation rows.
      */
     bonusBps?: string | null;
     /**

package/dist/stellar-lending/list.d.ts

@@ -76,6 +76,8 @@ export interface StellarAssetPageMarket {
     isBorrowable: boolean;
     paused: boolean;
     frozen: boolean;
+    /** Spoke-asset `no_seize`: cannot be taken as liquidation collateral. */
+    noSeize: boolean;
     supplyCapShort: number;
     borrowCapShort: number;
     depositCapFilledPct: number;

package/package.json

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