@kamino-finance/klend-sdk 5.15.2 → 5.15.3

package/dist/tests/src/@codegen/klend/types/ObligationLiquidity.js

@@ -0,0 +1,141 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObligationLiquidity = void 0;
+const kit_1 = require("@solana/kit"); // eslint-disable-line @typescript-eslint/no-unused-vars
+const bn_js_1 = __importDefault(require("bn.js")); // eslint-disable-line @typescript-eslint/no-unused-vars
+const types = __importStar(require("../types")); // eslint-disable-line @typescript-eslint/no-unused-vars
+const borsh = __importStar(require("@coral-xyz/borsh"));
+const utils_1 = require("../utils");
+/** Obligation liquidity state */
+class ObligationLiquidity {
+    /** Reserve liquidity is borrowed from */
+    borrowReserve;
+    /** Borrow rate used for calculating interest (big scaled fraction) */
+    cumulativeBorrowRateBsf;
+    padding;
+    /** Amount of liquidity borrowed plus interest (scaled fraction) */
+    borrowedAmountSf;
+    /** Liquidity market value in quote currency (scaled fraction) */
+    marketValueSf;
+    /** Risk adjusted liquidity market value in quote currency - DEBUG ONLY - use market_value instead */
+    borrowFactorAdjustedMarketValueSf;
+    /** Amount of liquidity borrowed outside of an elevation group */
+    borrowedAmountOutsideElevationGroups;
+    padding2;
+    constructor(fields) {
+        this.borrowReserve = fields.borrowReserve;
+        this.cumulativeBorrowRateBsf = new types.BigFractionBytes({
+            ...fields.cumulativeBorrowRateBsf,
+        });
+        this.padding = fields.padding;
+        this.borrowedAmountSf = fields.borrowedAmountSf;
+        this.marketValueSf = fields.marketValueSf;
+        this.borrowFactorAdjustedMarketValueSf =
+            fields.borrowFactorAdjustedMarketValueSf;
+        this.borrowedAmountOutsideElevationGroups =
+            fields.borrowedAmountOutsideElevationGroups;
+        this.padding2 = fields.padding2;
+    }
+    static layout(property) {
+        return borsh.struct([
+            (0, utils_1.borshAddress)("borrowReserve"),
+            types.BigFractionBytes.layout("cumulativeBorrowRateBsf"),
+            borsh.u64("padding"),
+            borsh.u128("borrowedAmountSf"),
+            borsh.u128("marketValueSf"),
+            borsh.u128("borrowFactorAdjustedMarketValueSf"),
+            borsh.u64("borrowedAmountOutsideElevationGroups"),
+            borsh.array(borsh.u64(), 7, "padding2"),
+        ], property);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static fromDecoded(obj) {
+        return new ObligationLiquidity({
+            borrowReserve: obj.borrowReserve,
+            cumulativeBorrowRateBsf: types.BigFractionBytes.fromDecoded(obj.cumulativeBorrowRateBsf),
+            padding: obj.padding,
+            borrowedAmountSf: obj.borrowedAmountSf,
+            marketValueSf: obj.marketValueSf,
+            borrowFactorAdjustedMarketValueSf: obj.borrowFactorAdjustedMarketValueSf,
+            borrowedAmountOutsideElevationGroups: obj.borrowedAmountOutsideElevationGroups,
+            padding2: obj.padding2,
+        });
+    }
+    static toEncodable(fields) {
+        return {
+            borrowReserve: fields.borrowReserve,
+            cumulativeBorrowRateBsf: types.BigFractionBytes.toEncodable(fields.cumulativeBorrowRateBsf),
+            padding: fields.padding,
+            borrowedAmountSf: fields.borrowedAmountSf,
+            marketValueSf: fields.marketValueSf,
+            borrowFactorAdjustedMarketValueSf: fields.borrowFactorAdjustedMarketValueSf,
+            borrowedAmountOutsideElevationGroups: fields.borrowedAmountOutsideElevationGroups,
+            padding2: fields.padding2,
+        };
+    }
+    toJSON() {
+        return {
+            borrowReserve: this.borrowReserve,
+            cumulativeBorrowRateBsf: this.cumulativeBorrowRateBsf.toJSON(),
+            padding: this.padding.toString(),
+            borrowedAmountSf: this.borrowedAmountSf.toString(),
+            marketValueSf: this.marketValueSf.toString(),
+            borrowFactorAdjustedMarketValueSf: this.borrowFactorAdjustedMarketValueSf.toString(),
+            borrowedAmountOutsideElevationGroups: this.borrowedAmountOutsideElevationGroups.toString(),
+            padding2: this.padding2.map((item) => item.toString()),
+        };
+    }
+    static fromJSON(obj) {
+        return new ObligationLiquidity({
+            borrowReserve: (0, kit_1.address)(obj.borrowReserve),
+            cumulativeBorrowRateBsf: types.BigFractionBytes.fromJSON(obj.cumulativeBorrowRateBsf),
+            padding: new bn_js_1.default(obj.padding),
+            borrowedAmountSf: new bn_js_1.default(obj.borrowedAmountSf),
+            marketValueSf: new bn_js_1.default(obj.marketValueSf),
+            borrowFactorAdjustedMarketValueSf: new bn_js_1.default(obj.borrowFactorAdjustedMarketValueSf),
+            borrowedAmountOutsideElevationGroups: new bn_js_1.default(obj.borrowedAmountOutsideElevationGroups),
+            padding2: obj.padding2.map((item) => new bn_js_1.default(item)),
+        });
+    }
+    toEncodable() {
+        return ObligationLiquidity.toEncodable(this);
+    }
+}
+exports.ObligationLiquidity = ObligationLiquidity;
+//# sourceMappingURL=ObligationLiquidity.js.map

package/dist/tests/src/@codegen/klend/types/ObligationLiquidity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObligationLiquidity.js","sourceRoot":"","sources":["../../../../../../src/@codegen/klend/types/ObligationLiquidity.ts"],"names":[],"mappings":"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"}

package/dist/tests/src/@codegen/klend/types/ObligationOrder.d.ts

@@ -0,0 +1,284 @@
+import BN from "bn.js";
+import * as types from "../types";
+export interface ObligationOrderFields {
+    /**
+     * A threshold value used by the condition (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::condition_type].
+     *
+     * Examples:
+     * - when `condition_type == 2 (UserLtvBelow)`:
+     * then a value of `0.455` here means that the order is active only when the obligation's
+     * user LTV is less than `0.455` (i.e. < 45.5%).
+     * - when `condition_type == 3 (DebtCollPriceRatioAbove)`:
+     * assuming the obligation uses BTC collateral for SOL debt, then a value of `491.3` here
+     * means that the order is active only when the BTC-SOL price is greater than `491.3` (i.e.
+     * > 491.3 SOL per BTC).
+     */
+    conditionThresholdSf: BN;
+    /**
+     * A configuration parameter used by the opportunity (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::opportunity_type].
+     *
+     * Examples:
+     * - when `opportunity_type == 0 (DeleverageSingleDebtAmount)`:
+     * Assuming the obligation uses BTC collateral for SOL debt, then a value of `1_234_000_000`
+     * here means that a liquidator may repay up to 1234000000 lamports (i.e. 1.234 SOL) on this
+     * obligation.
+     * Note: the special value of [Fraction::MAX] is *not* allowed in this case.
+     * - when `opportunity_type == 1 (DeleverageAllDebtAmount)`:
+     * The only allowed value in this case is [Fraction::MAX] (to emphasize that *all* debt
+     * should be repaid).
+     */
+    opportunityParameterSf: BN;
+    /**
+     * A *minimum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The minimum bonus is applied exactly when the [Self::condition_threshold_sf] is met, and
+     * grows linearly towards the [Self::max_execution_bonus_bps].
+     *
+     * Example: a value of `50` here means 50bps == 0.5% bonus for an "LTV > 65%" order, when
+     * executed precisely at the moment LTV exceeds 65%.
+     */
+    minExecutionBonusBps: number;
+    /**
+     * A *maximum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The maximum bonus is applied at the relevant "extreme" state of the obligation, i.e.:
+     * - for a stop-loss condition, it is a point at which the obligation becomes liquidatable;
+     * - for a take-profit condition, it is a point at which obligation has 0% LTV.
+     *
+     * In non-extreme states, the actual bonus value is interpolated linearly, starting from
+     * [Self::min_execution_bonus_bps] (at the point specified by the order's condition).
+     *
+     * Example: a value of `300` here means 300bps == 3.0% bonus for a "debt/coll price > 140"
+     * order, when executed at a higher price = 200, at which the obligation's LTV happens to
+     * be equal to its liquidation LTV.
+     */
+    maxExecutionBonusBps: number;
+    /**
+     * Serialized [ConditionType].
+     * The entire order is void when this is zeroed (i.e. representing [ConditionType::Never]).
+     *
+     * Example: a value of `2` here denotes `UserLtvBelow` condition type. Of course, to
+     * interpret this condition, we also need to take the [Self::condition_threshold_sf] into
+     * account.
+     */
+    conditionType: number;
+    /**
+     * Serialized [OpportunityType].
+     *
+     * Example: a value of `0` here denotes `DeleverageSingleDebtAmount` opportunity. Of course, to
+     * interpret this opportunity, we also need to take the [Self::opportunity_parameter_sf] into
+     * account.
+     */
+    opportunityType: number;
+    /**
+     * Internal padding.
+     * The fields above take up 2+2+1+1 bytes = 48 bits, which means we need 80 bits = 10 bytes to
+     * align with `u128`s.
+     */
+    padding1: Array<number>;
+    /**
+     * End padding.
+     * The total size of a single instance is 8*u128 = 128 bytes.
+     */
+    padding2: Array<BN>;
+}
+export interface ObligationOrderJSON {
+    /**
+     * A threshold value used by the condition (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::condition_type].
+     *
+     * Examples:
+     * - when `condition_type == 2 (UserLtvBelow)`:
+     * then a value of `0.455` here means that the order is active only when the obligation's
+     * user LTV is less than `0.455` (i.e. < 45.5%).
+     * - when `condition_type == 3 (DebtCollPriceRatioAbove)`:
+     * assuming the obligation uses BTC collateral for SOL debt, then a value of `491.3` here
+     * means that the order is active only when the BTC-SOL price is greater than `491.3` (i.e.
+     * > 491.3 SOL per BTC).
+     */
+    conditionThresholdSf: string;
+    /**
+     * A configuration parameter used by the opportunity (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::opportunity_type].
+     *
+     * Examples:
+     * - when `opportunity_type == 0 (DeleverageSingleDebtAmount)`:
+     * Assuming the obligation uses BTC collateral for SOL debt, then a value of `1_234_000_000`
+     * here means that a liquidator may repay up to 1234000000 lamports (i.e. 1.234 SOL) on this
+     * obligation.
+     * Note: the special value of [Fraction::MAX] is *not* allowed in this case.
+     * - when `opportunity_type == 1 (DeleverageAllDebtAmount)`:
+     * The only allowed value in this case is [Fraction::MAX] (to emphasize that *all* debt
+     * should be repaid).
+     */
+    opportunityParameterSf: string;
+    /**
+     * A *minimum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The minimum bonus is applied exactly when the [Self::condition_threshold_sf] is met, and
+     * grows linearly towards the [Self::max_execution_bonus_bps].
+     *
+     * Example: a value of `50` here means 50bps == 0.5% bonus for an "LTV > 65%" order, when
+     * executed precisely at the moment LTV exceeds 65%.
+     */
+    minExecutionBonusBps: number;
+    /**
+     * A *maximum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The maximum bonus is applied at the relevant "extreme" state of the obligation, i.e.:
+     * - for a stop-loss condition, it is a point at which the obligation becomes liquidatable;
+     * - for a take-profit condition, it is a point at which obligation has 0% LTV.
+     *
+     * In non-extreme states, the actual bonus value is interpolated linearly, starting from
+     * [Self::min_execution_bonus_bps] (at the point specified by the order's condition).
+     *
+     * Example: a value of `300` here means 300bps == 3.0% bonus for a "debt/coll price > 140"
+     * order, when executed at a higher price = 200, at which the obligation's LTV happens to
+     * be equal to its liquidation LTV.
+     */
+    maxExecutionBonusBps: number;
+    /**
+     * Serialized [ConditionType].
+     * The entire order is void when this is zeroed (i.e. representing [ConditionType::Never]).
+     *
+     * Example: a value of `2` here denotes `UserLtvBelow` condition type. Of course, to
+     * interpret this condition, we also need to take the [Self::condition_threshold_sf] into
+     * account.
+     */
+    conditionType: number;
+    /**
+     * Serialized [OpportunityType].
+     *
+     * Example: a value of `0` here denotes `DeleverageSingleDebtAmount` opportunity. Of course, to
+     * interpret this opportunity, we also need to take the [Self::opportunity_parameter_sf] into
+     * account.
+     */
+    opportunityType: number;
+    /**
+     * Internal padding.
+     * The fields above take up 2+2+1+1 bytes = 48 bits, which means we need 80 bits = 10 bytes to
+     * align with `u128`s.
+     */
+    padding1: Array<number>;
+    /**
+     * End padding.
+     * The total size of a single instance is 8*u128 = 128 bytes.
+     */
+    padding2: Array<string>;
+}
+/**
+ * A single obligation order.
+ * See [Obligation::orders].
+ */
+export declare class ObligationOrder {
+    /**
+     * A threshold value used by the condition (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::condition_type].
+     *
+     * Examples:
+     * - when `condition_type == 2 (UserLtvBelow)`:
+     * then a value of `0.455` here means that the order is active only when the obligation's
+     * user LTV is less than `0.455` (i.e. < 45.5%).
+     * - when `condition_type == 3 (DebtCollPriceRatioAbove)`:
+     * assuming the obligation uses BTC collateral for SOL debt, then a value of `491.3` here
+     * means that the order is active only when the BTC-SOL price is greater than `491.3` (i.e.
+     * > 491.3 SOL per BTC).
+     */
+    readonly conditionThresholdSf: BN;
+    /**
+     * A configuration parameter used by the opportunity (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::opportunity_type].
+     *
+     * Examples:
+     * - when `opportunity_type == 0 (DeleverageSingleDebtAmount)`:
+     * Assuming the obligation uses BTC collateral for SOL debt, then a value of `1_234_000_000`
+     * here means that a liquidator may repay up to 1234000000 lamports (i.e. 1.234 SOL) on this
+     * obligation.
+     * Note: the special value of [Fraction::MAX] is *not* allowed in this case.
+     * - when `opportunity_type == 1 (DeleverageAllDebtAmount)`:
+     * The only allowed value in this case is [Fraction::MAX] (to emphasize that *all* debt
+     * should be repaid).
+     */
+    readonly opportunityParameterSf: BN;
+    /**
+     * A *minimum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The minimum bonus is applied exactly when the [Self::condition_threshold_sf] is met, and
+     * grows linearly towards the [Self::max_execution_bonus_bps].
+     *
+     * Example: a value of `50` here means 50bps == 0.5% bonus for an "LTV > 65%" order, when
+     * executed precisely at the moment LTV exceeds 65%.
+     */
+    readonly minExecutionBonusBps: number;
+    /**
+     * A *maximum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The maximum bonus is applied at the relevant "extreme" state of the obligation, i.e.:
+     * - for a stop-loss condition, it is a point at which the obligation becomes liquidatable;
+     * - for a take-profit condition, it is a point at which obligation has 0% LTV.
+     *
+     * In non-extreme states, the actual bonus value is interpolated linearly, starting from
+     * [Self::min_execution_bonus_bps] (at the point specified by the order's condition).
+     *
+     * Example: a value of `300` here means 300bps == 3.0% bonus for a "debt/coll price > 140"
+     * order, when executed at a higher price = 200, at which the obligation's LTV happens to
+     * be equal to its liquidation LTV.
+     */
+    readonly maxExecutionBonusBps: number;
+    /**
+     * Serialized [ConditionType].
+     * The entire order is void when this is zeroed (i.e. representing [ConditionType::Never]).
+     *
+     * Example: a value of `2` here denotes `UserLtvBelow` condition type. Of course, to
+     * interpret this condition, we also need to take the [Self::condition_threshold_sf] into
+     * account.
+     */
+    readonly conditionType: number;
+    /**
+     * Serialized [OpportunityType].
+     *
+     * Example: a value of `0` here denotes `DeleverageSingleDebtAmount` opportunity. Of course, to
+     * interpret this opportunity, we also need to take the [Self::opportunity_parameter_sf] into
+     * account.
+     */
+    readonly opportunityType: number;
+    /**
+     * Internal padding.
+     * The fields above take up 2+2+1+1 bytes = 48 bits, which means we need 80 bits = 10 bytes to
+     * align with `u128`s.
+     */
+    readonly padding1: Array<number>;
+    /**
+     * End padding.
+     * The total size of a single instance is 8*u128 = 128 bytes.
+     */
+    readonly padding2: Array<BN>;
+    constructor(fields: ObligationOrderFields);
+    static layout(property?: string): import("buffer-layout").Layout<unknown>;
+    static fromDecoded(obj: any): types.ObligationOrder;
+    static toEncodable(fields: ObligationOrderFields): {
+        conditionThresholdSf: BN;
+        opportunityParameterSf: BN;
+        minExecutionBonusBps: number;
+        maxExecutionBonusBps: number;
+        conditionType: number;
+        opportunityType: number;
+        padding1: number[];
+        padding2: BN[];
+    };
+    toJSON(): ObligationOrderJSON;
+    static fromJSON(obj: ObligationOrderJSON): ObligationOrder;
+    toEncodable(): {
+        conditionThresholdSf: BN;
+        opportunityParameterSf: BN;
+        minExecutionBonusBps: number;
+        maxExecutionBonusBps: number;
+        conditionType: number;
+        opportunityType: number;
+        padding1: number[];
+        padding2: BN[];
+    };
+}
+//# sourceMappingURL=ObligationOrder.d.ts.map

package/dist/tests/src/@codegen/klend/types/ObligationOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObligationOrder.d.ts","sourceRoot":"","sources":["../../../../../../src/@codegen/klend/types/ObligationOrder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,OAAO,CAAA;AACtB,OAAO,KAAK,KAAK,MAAM,UAAU,CAAA;AAIjC,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;OAYG;IACH,oBAAoB,EAAE,EAAE,CAAA;IACxB;;;;;;;;;;;;;OAaG;IACH,sBAAsB,EAAE,EAAE,CAAA;IAC1B;;;;;;;;OAQG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;OAaG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;OAYG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;OAaG;IACH,sBAAsB,EAAE,MAAM,CAAA;IAC9B;;;;;;;;OAQG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;;;;;;;OAaG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B;;;;;;;OAOG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,oBAAoB,EAAE,EAAE,CAAA;IACjC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,sBAAsB,EAAE,EAAE,CAAA;IACnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;gBAEhB,MAAM,EAAE,qBAAqB;IAWzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM;IAiB/B,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG;IAa3B,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,qBAAqB;;;;;;;;;;IAahD,MAAM,IAAI,mBAAmB;IAa7B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,eAAe;IAa1D,WAAW;;;;;;;;;;CAGZ"}

package/dist/tests/src/@codegen/klend/types/ObligationOrder.js

@@ -0,0 +1,205 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObligationOrder = void 0;
+const bn_js_1 = __importDefault(require("bn.js")); // eslint-disable-line @typescript-eslint/no-unused-vars
+const borsh = __importStar(require("@coral-xyz/borsh"));
+/**
+ * A single obligation order.
+ * See [Obligation::orders].
+ */
+class ObligationOrder {
+    /**
+     * A threshold value used by the condition (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::condition_type].
+     *
+     * Examples:
+     * - when `condition_type == 2 (UserLtvBelow)`:
+     * then a value of `0.455` here means that the order is active only when the obligation's
+     * user LTV is less than `0.455` (i.e. < 45.5%).
+     * - when `condition_type == 3 (DebtCollPriceRatioAbove)`:
+     * assuming the obligation uses BTC collateral for SOL debt, then a value of `491.3` here
+     * means that the order is active only when the BTC-SOL price is greater than `491.3` (i.e.
+     * > 491.3 SOL per BTC).
+     */
+    conditionThresholdSf;
+    /**
+     * A configuration parameter used by the opportunity (scaled [Fraction]).
+     * The exact meaning depends on the specific [Self::opportunity_type].
+     *
+     * Examples:
+     * - when `opportunity_type == 0 (DeleverageSingleDebtAmount)`:
+     * Assuming the obligation uses BTC collateral for SOL debt, then a value of `1_234_000_000`
+     * here means that a liquidator may repay up to 1234000000 lamports (i.e. 1.234 SOL) on this
+     * obligation.
+     * Note: the special value of [Fraction::MAX] is *not* allowed in this case.
+     * - when `opportunity_type == 1 (DeleverageAllDebtAmount)`:
+     * The only allowed value in this case is [Fraction::MAX] (to emphasize that *all* debt
+     * should be repaid).
+     */
+    opportunityParameterSf;
+    /**
+     * A *minimum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The minimum bonus is applied exactly when the [Self::condition_threshold_sf] is met, and
+     * grows linearly towards the [Self::max_execution_bonus_bps].
+     *
+     * Example: a value of `50` here means 50bps == 0.5% bonus for an "LTV > 65%" order, when
+     * executed precisely at the moment LTV exceeds 65%.
+     */
+    minExecutionBonusBps;
+    /**
+     * A *maximum* additional fraction of collateral transferred to the liquidator, in bps.
+     *
+     * The maximum bonus is applied at the relevant "extreme" state of the obligation, i.e.:
+     * - for a stop-loss condition, it is a point at which the obligation becomes liquidatable;
+     * - for a take-profit condition, it is a point at which obligation has 0% LTV.
+     *
+     * In non-extreme states, the actual bonus value is interpolated linearly, starting from
+     * [Self::min_execution_bonus_bps] (at the point specified by the order's condition).
+     *
+     * Example: a value of `300` here means 300bps == 3.0% bonus for a "debt/coll price > 140"
+     * order, when executed at a higher price = 200, at which the obligation's LTV happens to
+     * be equal to its liquidation LTV.
+     */
+    maxExecutionBonusBps;
+    /**
+     * Serialized [ConditionType].
+     * The entire order is void when this is zeroed (i.e. representing [ConditionType::Never]).
+     *
+     * Example: a value of `2` here denotes `UserLtvBelow` condition type. Of course, to
+     * interpret this condition, we also need to take the [Self::condition_threshold_sf] into
+     * account.
+     */
+    conditionType;
+    /**
+     * Serialized [OpportunityType].
+     *
+     * Example: a value of `0` here denotes `DeleverageSingleDebtAmount` opportunity. Of course, to
+     * interpret this opportunity, we also need to take the [Self::opportunity_parameter_sf] into
+     * account.
+     */
+    opportunityType;
+    /**
+     * Internal padding.
+     * The fields above take up 2+2+1+1 bytes = 48 bits, which means we need 80 bits = 10 bytes to
+     * align with `u128`s.
+     */
+    padding1;
+    /**
+     * End padding.
+     * The total size of a single instance is 8*u128 = 128 bytes.
+     */
+    padding2;
+    constructor(fields) {
+        this.conditionThresholdSf = fields.conditionThresholdSf;
+        this.opportunityParameterSf = fields.opportunityParameterSf;
+        this.minExecutionBonusBps = fields.minExecutionBonusBps;
+        this.maxExecutionBonusBps = fields.maxExecutionBonusBps;
+        this.conditionType = fields.conditionType;
+        this.opportunityType = fields.opportunityType;
+        this.padding1 = fields.padding1;
+        this.padding2 = fields.padding2;
+    }
+    static layout(property) {
+        return borsh.struct([
+            borsh.u128("conditionThresholdSf"),
+            borsh.u128("opportunityParameterSf"),
+            borsh.u16("minExecutionBonusBps"),
+            borsh.u16("maxExecutionBonusBps"),
+            borsh.u8("conditionType"),
+            borsh.u8("opportunityType"),
+            borsh.array(borsh.u8(), 10, "padding1"),
+            borsh.array(borsh.u128(), 5, "padding2"),
+        ], property);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static fromDecoded(obj) {
+        return new ObligationOrder({
+            conditionThresholdSf: obj.conditionThresholdSf,
+            opportunityParameterSf: obj.opportunityParameterSf,
+            minExecutionBonusBps: obj.minExecutionBonusBps,
+            maxExecutionBonusBps: obj.maxExecutionBonusBps,
+            conditionType: obj.conditionType,
+            opportunityType: obj.opportunityType,
+            padding1: obj.padding1,
+            padding2: obj.padding2,
+        });
+    }
+    static toEncodable(fields) {
+        return {
+            conditionThresholdSf: fields.conditionThresholdSf,
+            opportunityParameterSf: fields.opportunityParameterSf,
+            minExecutionBonusBps: fields.minExecutionBonusBps,
+            maxExecutionBonusBps: fields.maxExecutionBonusBps,
+            conditionType: fields.conditionType,
+            opportunityType: fields.opportunityType,
+            padding1: fields.padding1,
+            padding2: fields.padding2,
+        };
+    }
+    toJSON() {
+        return {
+            conditionThresholdSf: this.conditionThresholdSf.toString(),
+            opportunityParameterSf: this.opportunityParameterSf.toString(),
+            minExecutionBonusBps: this.minExecutionBonusBps,
+            maxExecutionBonusBps: this.maxExecutionBonusBps,
+            conditionType: this.conditionType,
+            opportunityType: this.opportunityType,
+            padding1: this.padding1,
+            padding2: this.padding2.map((item) => item.toString()),
+        };
+    }
+    static fromJSON(obj) {
+        return new ObligationOrder({
+            conditionThresholdSf: new bn_js_1.default(obj.conditionThresholdSf),
+            opportunityParameterSf: new bn_js_1.default(obj.opportunityParameterSf),
+            minExecutionBonusBps: obj.minExecutionBonusBps,
+            maxExecutionBonusBps: obj.maxExecutionBonusBps,
+            conditionType: obj.conditionType,
+            opportunityType: obj.opportunityType,
+            padding1: obj.padding1,
+            padding2: obj.padding2.map((item) => new bn_js_1.default(item)),
+        });
+    }
+    toEncodable() {
+        return ObligationOrder.toEncodable(this);
+    }
+}
+exports.ObligationOrder = ObligationOrder;
+//# sourceMappingURL=ObligationOrder.js.map

package/dist/tests/src/@codegen/klend/types/ObligationOrder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObligationOrder.js","sourceRoot":"","sources":["../../../../../../src/@codegen/klend/types/ObligationOrder.ts"],"names":[],"mappings":"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"}