@gvnrdao/dh-lit-actions 0.0.61 → 0.0.68

package/pkg-dist/src/modules/business-rules-math.module.js

@@ -0,0 +1,309 @@
+"use strict";
+/**
+ * Business Rules Math Module
+ *
+ * Pure calculation functions for Diamond Hands Protocol business logic.
+ * These functions contain no side effects - they only perform calculations.
+ *
+ * Used by vault-snapshot and other modules for consistent math across the system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateTermStartFromExpiry = calculateTermStartFromExpiry;
+exports.calculateTermStatus = calculateTermStatus;
+exports.calculateLiquidationThreshold = calculateLiquidationThreshold;
+exports.calculateCollateralMetrics = calculateCollateralMetrics;
+exports.hasSufficientCollateralForDebt = hasSufficientCollateralForDebt;
+exports.calculateFeeBps = calculateFeeBps;
+exports.calculateBtcValueUsd = calculateBtcValueUsd;
+exports.calculateCollateralRatioBps = calculateCollateralRatioBps;
+exports.isCollateralSufficient = isCollateralSufficient;
+exports.bpsToPercent = bpsToPercent;
+const constants_1 = require("../constants");
+/**
+ * Calculate term start timestamp from expiry timestamp and term length
+ *
+ * Contract stores expiryAt but not termStartTimestamp.
+ * We derive it: termStart = expiry - (termLength * 30 days)
+ *
+ * Uses constants to avoid magic numbers and ensure accuracy.
+ *
+ * @param expiryTimestamp - Unix timestamp when term expires (0 if no term)
+ * @param termLengthMonths - Term length in months
+ * @returns Unix timestamp when term started (0 if no term)
+ */
+function calculateTermStartFromExpiry(expiryTimestamp, termLengthMonths) {
+    // No term started if expiryAt is 0
+    if (expiryTimestamp === 0) {
+        return 0;
+    }
+    // Constants for time calculations
+    const SECONDS_PER_DAY = 86400;
+    const DAYS_PER_MONTH = 30;
+    // Calculate term start
+    // termStart = expiry - (months * 30 days/month * 86400 seconds/day)
+    const termDurationSeconds = termLengthMonths * DAYS_PER_MONTH * SECONDS_PER_DAY;
+    return expiryTimestamp - termDurationSeconds;
+}
+/**
+ * Calculate term status from timestamps
+ *
+ * Determines:
+ * - How long into the term we are
+ * - Whether term is expired
+ * - Days until expiry or days into grace period
+ *
+ * @param termStartTimestamp - Unix timestamp when term started (0 if not started)
+ * @param selectedTermMonths - Term length in months
+ * @returns Complete term status metrics
+ */
+function calculateTermStatus(termStartTimestamp, selectedTermMonths) {
+    // If no term started yet (no debt), return zeros
+    if (termStartTimestamp === 0) {
+        return {
+            termDurationDays: 0,
+            termLengthDays: selectedTermMonths * 30,
+            isExpired: false,
+            daysUntilExpiry: selectedTermMonths * 30,
+            daysIntoGracePeriod: 0,
+        };
+    }
+    const now = Math.floor(Date.now() / 1000);
+    const termLengthDays = selectedTermMonths * 30;
+    const termDurationSeconds = now - termStartTimestamp;
+    const termDurationDays = Math.floor(termDurationSeconds / 86400);
+    const isExpired = termDurationDays > termLengthDays;
+    const daysUntilExpiry = Math.max(0, termLengthDays - termDurationDays);
+    const daysIntoGracePeriod = Math.max(0, termDurationDays - termLengthDays);
+    return {
+        termDurationDays,
+        termLengthDays,
+        isExpired,
+        daysUntilExpiry,
+        daysIntoGracePeriod,
+    };
+}
+/**
+ * Calculate current liquidation threshold with grace period escalation
+ *
+ * Active loan: 130% (13000 bps)
+ * Expired:
+ *   Day 0: 110% (11000 bps)
+ *   Day 30: 200% (20000 bps)
+ *   Quadratic escalation between
+ *
+ * Uses integer-only math for deterministic results across all platforms.
+ *
+ * @param isExpired - Whether loan is expired
+ * @param daysIntoGracePeriod - Days past expiry (0 if not expired)
+ * @returns Liquidation threshold in basis points
+ */
+function calculateLiquidationThreshold(isExpired, daysIntoGracePeriod) {
+    // Active loan: Use protocol constant
+    if (!isExpired) {
+        return constants_1.ACTIVE_LOAN_LIQUIDATION_THRESHOLD_BPS;
+    }
+    // Expired: escalate from MIN to MAX over grace period using protocol constants
+    // Cap at grace period days
+    const day = Math.min(daysIntoGracePeriod, constants_1.GRACE_PERIOD_DAYS);
+    // Quadratic curve using ONLY integer math for determinism:
+    // threshold = MIN + ((day^2 / GRACE_PERIOD_DAYS^2) * (MAX - MIN))
+    //
+    // This avoids floating point entirely while maintaining quadratic curve
+    const daySquared = day * day;
+    const escalation = (daySquared *
+        (constants_1.EXPIRED_LOAN_MAX_LIQUIDATION_THRESHOLD_BPS -
+            constants_1.EXPIRED_LOAN_MIN_LIQUIDATION_THRESHOLD_BPS)) /
+        (constants_1.GRACE_PERIOD_DAYS * constants_1.GRACE_PERIOD_DAYS);
+    const threshold = constants_1.EXPIRED_LOAN_MIN_LIQUIDATION_THRESHOLD_BPS + escalation;
+    return threshold;
+}
+/**
+ * Calculate collateral metrics from BTC balance and debt
+ *
+ * Converts BTC balance to USD value and calculates collateral ratio.
+ * Uses BigInt for all calculations to avoid JavaScript number precision issues.
+ *
+ * @param availableBTCSats - Available BTC balance in satoshis
+ * @param btcPriceUsd - BTC price with 8 decimals (e.g., 10000000000000 = $100,000)
+ * @param ucdDebt - UCD debt in wei (18 decimals)
+ * @returns Collateral value in USD and ratio in basis points
+ */
+function calculateCollateralMetrics(availableBTCSats, btcPriceUsd, ucdDebt) {
+    // Convert available BTC to USD value using BigInt math
+    // btcPriceUsd has 8 decimals: $100,000 = 10000000000000n
+    // availableBTCSats is in satoshis: 1 BTC = 100_000_000n sats
+    // ucdDebt has 18 decimals (ERC20 wei)
+    //
+    // Formula: (sats * priceWith8Decimals) / (SATOSHIS_PER_BITCOIN * PRICE_ORACLE_DECIMALS)
+    // This gives us USD value with 0 decimals (whole dollars)
+    // Calculate collateral value in USD (no decimals) - ALWAYS calculate, even with no debt
+    const collateralValueUsd = (availableBTCSats * btcPriceUsd) /
+        (constants_1.SATOSHIS_PER_BITCOIN * constants_1.PRICE_ORACLE_DECIMALS);
+    // If no debt, return max safe collateral ratio
+    if (ucdDebt === 0n) {
+        return {
+            collateralValueUsd,
+            collateralRatioBps: Number.MAX_SAFE_INTEGER,
+        };
+    }
+    // Calculate collateral ratio in basis points
+    // Ratio = (collateral / debt) * 10000
+    // Example: $20,000 collateral / $10,000 debt = 2.0 = 20000 bps (200%)
+    //
+    // CRITICAL: We must preserve precision by doing multiplication BEFORE division
+    // Use debt in wei (18 decimals) directly, adjust for collateral being in whole dollars
+    //
+    // Formula: (collateralUSD * UCD_TOKEN_DECIMALS * 10000) / ucdDebt
+    const ratioBigInt = (collateralValueUsd * constants_1.UCD_TOKEN_DECIMALS * 10000n) / ucdDebt;
+    // Convert to number - safe because ratio will be small (typically 10000-30000)
+    const collateralRatioBps = Number(ratioBigInt);
+    return {
+        collateralValueUsd,
+        collateralRatioBps,
+    };
+}
+/**
+ * Check if adding additional debt would maintain required collateral ratio
+ *
+ * Used by minting authorization to validate new mints.
+ *
+ * @param collateralValueUsd - Current collateral value in USD (whole dollars)
+ * @param currentDebt - Current UCD debt in wei (18 decimals)
+ * @param additionalDebt - Additional UCD debt to add in wei (18 decimals)
+ * @param requiredRatioBps - Required collateral ratio in basis points (e.g., 13000 for 130%)
+ * @returns True if sufficient collateral exists after adding debt
+ */
+function hasSufficientCollateralForDebt(collateralValueUsd, currentDebt, additionalDebt, requiredRatioBps) {
+    // Calculate new total debt
+    const newTotalDebt = currentDebt + additionalDebt;
+    // If no debt after addition, always sufficient
+    if (newTotalDebt === 0n) {
+        return true;
+    }
+    // Calculate new collateral ratio using precise BigInt math
+    // Must multiply BEFORE dividing to preserve precision (same as calculateCollateralMetrics)
+    const newCollateralRatioBps = Number((collateralValueUsd * constants_1.UCD_TOKEN_DECIMALS * 10000n) / newTotalDebt);
+    return newCollateralRatioBps >= requiredRatioBps;
+}
+/**
+ * Calculate fee from amount using basis points
+ *
+ * Bulletproof fee calculation with validation.
+ * Multiply before divide to maintain precision.
+ *
+ * @param amount - Principal amount (in wei or sats)
+ * @param feeBps - Fee in basis points (e.g., 50 = 0.5%)
+ * @returns Fee amount in same units as input
+ *
+ * @example
+ * calculateFeeBps(1000000000000000000n, 50) // 0.5% of 1 ETH
+ * // Returns: 5000000000000000n (0.005 ETH)
+ */
+function calculateFeeBps(amount, feeBps) {
+    if (amount < 0n) {
+        throw new Error("Amount cannot be negative");
+    }
+    if (feeBps < 0 || feeBps > 10000) {
+        throw new Error("Fee basis points must be between 0 and 10000 (0% to 100%)");
+    }
+    // Multiply first to preserve precision, then divide
+    const fee = (amount * BigInt(feeBps)) / 10000n;
+    return fee;
+}
+/**
+ * Calculate USD value of BTC amount
+ *
+ * Converts satoshis to USD using price with 8 decimals.
+ * Result maintains 8 decimal precision.
+ *
+ * @param btcSats - Bitcoin amount in satoshis
+ * @param btcPriceUsd8Decimals - BTC price with 8 decimals (e.g., 9800000000000n = $98,000)
+ * @returns USD value with 8 decimals
+ *
+ * @example
+ * calculateBtcValueUsd(100000000n, 9800000000000n) // 1 BTC at $98,000
+ * // Returns: 9800000000000n ($98,000 with 8 decimals)
+ */
+function calculateBtcValueUsd(btcSats, btcPriceUsd8Decimals) {
+    if (btcSats < 0n) {
+        throw new Error("BTC amount cannot be negative");
+    }
+    if (btcPriceUsd8Decimals <= 0n) {
+        throw new Error("BTC price must be positive");
+    }
+    // btcSats: satoshis (no decimals)
+    // btcPriceUsd8Decimals: price with 8 decimals
+    // Formula: (sats * priceWith8Decimals) / SATOSHIS_PER_BITCOIN
+    // Result: USD value with 8 decimals
+    const valueUsd = (btcSats * btcPriceUsd8Decimals) / constants_1.SATOSHIS_PER_BITCOIN;
+    return valueUsd;
+}
+/**
+ * Calculate collateral ratio in basis points (with 8-decimal collateral and 18-decimal debt)
+ *
+ * Used for UCD mint validation where collateral is in USD (8 decimals)
+ * and debt is in UCD wei (18 decimals).
+ *
+ * @param collateralValueUsd8Decimals - Collateral value in USD with 8 decimals
+ * @param debtUsd18Decimals - Debt amount in USD with 18 decimals (UCD wei)
+ * @returns Collateral ratio in basis points (e.g., 20000 = 200%)
+ *
+ * @example
+ * calculateCollateralRatioBps(9800000000000n, 4000000000000000000000n)
+ * // $98,000 collateral / $4,000 debt = 24.5 = 2450% = 24500 bps
+ * // Returns: 24500
+ */
+function calculateCollateralRatioBps(collateralValueUsd8Decimals, debtUsd18Decimals) {
+    if (collateralValueUsd8Decimals < 0n) {
+        throw new Error("Collateral value cannot be negative");
+    }
+    if (debtUsd18Decimals <= 0n) {
+        throw new Error("Debt must be positive to calculate ratio");
+    }
+    // Scale collateral from 8 decimals to 18 decimals: multiply by 10^10
+    const scaledCollateral = collateralValueUsd8Decimals * 10000000000n;
+    // Ratio in basis points = (collateral / debt) * 10000
+    // Multiply first to preserve precision
+    const ratioBps = (scaledCollateral * 10000n) / debtUsd18Decimals;
+    // Convert to number for comparison
+    const ratioBpsNumber = Number(ratioBps);
+    // Sanity check: ratio should be reasonable (0% to 10,000,000%)
+    if (ratioBpsNumber < 0 || ratioBpsNumber > 100000000) {
+        throw new Error(`Collateral ratio out of bounds: ${ratioBpsNumber} bps (${ratioBpsNumber / 100}%)`);
+    }
+    return ratioBpsNumber;
+}
+/**
+ * Check if collateral ratio meets minimum requirement
+ *
+ * @param collateralValueUsd8Decimals - Collateral value in USD with 8 decimals
+ * @param debtUsd18Decimals - Debt amount in USD with 18 decimals
+ * @param minimumRatioBps - Minimum required ratio in basis points (e.g., 20000 = 200%)
+ * @returns True if collateral is sufficient
+ *
+ * @example
+ * isCollateralSufficient(20000000000000n, 10000000000000000000000n, 20000)
+ * // $200,000 collateral / $10,000 debt = 2000% >= 200%
+ * // Returns: true
+ */
+function isCollateralSufficient(collateralValueUsd8Decimals, debtUsd18Decimals, minimumRatioBps) {
+    if (minimumRatioBps < 0 || minimumRatioBps > 1000000) {
+        throw new Error("Minimum ratio must be between 0 and 1000000 bps (0% to 10000%)");
+    }
+    const actualRatioBps = calculateCollateralRatioBps(collateralValueUsd8Decimals, debtUsd18Decimals);
+    return actualRatioBps >= minimumRatioBps;
+}
+/**
+ * Convert basis points to percentage (for display)
+ *
+ * @param basisPoints - Value in basis points
+ * @returns Percentage as number (e.g., 20000 bps => 200)
+ *
+ * @example
+ * bpsToPercent(20000) // Returns: 200
+ * bpsToPercent(50) // Returns: 0.5
+ */
+function bpsToPercent(basisPoints) {
+    return basisPoints / 100;
+}
+//# sourceMappingURL=business-rules-math.module.js.map

package/pkg-dist/src/modules/business-rules-math.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-rules-math.module.js","sourceRoot":"","sources":["../../../src/modules/business-rules-math.module.ts"],"names":[],"mappings":"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"}

package/pkg-dist/src/modules/price-oracle.module.d.ts

@@ -0,0 +1,29 @@
+import { IPriceOracle, PriceSourceConfig } from "../interfaces/chunks/price-oracle.i";
+export declare class PriceOracleModule implements IPriceOracle {
+    private sources;
+    constructor(sources?: PriceSourceConfig[]);
+    private getDefaultSources;
+    /**
+     * Get BTC price in USD with 8 decimals
+     * Fetches from real price sources in priority order
+     */
+    getBTCPrice(): Promise<bigint>;
+    /**
+     * Consensus across multiple sources with outlier detection
+     * Returns median price from valid sources after filtering outliers
+     *
+     * Master's Wisdom: Two-Path Validation
+     * 1. If ONE source is outlier (>2% from median) → FILTER it, continue with remaining
+     * 2. If ALL sources too dispersed (>5% spread) → REJECT all, throw error
+     *
+     * Logic Flow:
+     * 1. Calculate initial median from all sources
+     * 2. Filter individual outliers (>2% from median)
+     * 3. If outliers found: remove them, require minimum 2 sources remaining
+     * 4. Recalculate median from valid sources only
+     * 5. Check if remaining sources are too dispersed (max/min ratio > 1.05)
+     * 6. Return final median or throw appropriate error
+     */
+    getBTCPriceConsensus(): Promise<bigint>;
+}
+//# sourceMappingURL=price-oracle.module.d.ts.map

package/pkg-dist/src/modules/price-oracle.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.module.d.ts","sourceRoot":"","sources":["../../../src/modules/price-oracle.module.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,iBAAiB,EAClB,MAAM,qCAAqC,CAAC;AAM7C,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,OAAO,CAAsB;gBAEzB,OAAO,CAAC,EAAE,iBAAiB,EAAE;IAKzC,OAAO,CAAC,iBAAiB;IAqGzB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAyCpC;;;;;;;;;;;;;;;OAeG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;CA+G9C"}

package/pkg-dist/src/modules/price-oracle.module.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PriceOracleModule = void 0;
+const constants_1 = require("../constants");
+class PriceOracleModule {
+    constructor(sources) {
+        this.sources = sources || this.getDefaultSources();
+        this.sources.sort((a, b) => a.priority - b.priority);
+    }
+    getDefaultSources() {
+        const DEFAULT_HEADERS = {
+            // LIT runtime rejects custom User-Agent headers (gRPC invalid_argument)
+            Accept: "application/json",
+        };
+        const fetchJson = async (url) => {
+            const controller = new AbortController();
+            // Reduced from 8000ms to 5000ms to fail faster and avoid LIT Protocol 30s timeout
+            // When CoinGecko fails, we need to quickly try Binance to stay under 30s limit
+            const timeoutMs = 5000;
+            const id = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const res = await fetch(url, {
+                    headers: DEFAULT_HEADERS,
+                    signal: controller.signal,
+                });
+                if (!res.ok) {
+                    throw new Error(`HTTP ${res.status} ${res.statusText}`);
+                }
+                return await res.json();
+            }
+            finally {
+                clearTimeout(id);
+            }
+        };
+        return [
+            {
+                name: "CoinGecko",
+                fetchPrice: async () => {
+                    // Each node fetches the price
+                    const url = new URL("https://api.coingecko.com/api/v3/simple/price");
+                    url.searchParams.set("ids", "bitcoin");
+                    url.searchParams.set("vs_currencies", "usd");
+                    const data = await fetchJson(url.toString());
+                    const price = Number(data?.bitcoin?.usd);
+                    if (!Number.isFinite(price) || price <= 0) {
+                        throw new Error("Invalid CoinGecko price payload");
+                    }
+                    // Master's wisdom: Use broadcastAndCollect to ensure consensus across all LIT nodes
+                    // Each node broadcasts its fetched price, then all receive all prices
+                    const allPrices = await Lit.Actions.broadcastAndCollect({
+                        name: "coinGeckoPrice",
+                        value: price.toString(),
+                    });
+                    const prices = allPrices.map((p) => parseFloat(p));
+                    prices.sort((a, b) => a - b);
+                    return prices[Math.floor(prices.length / 2)];
+                },
+                priority: 1,
+            },
+            {
+                name: "Binance",
+                fetchPrice: async () => {
+                    // Each node fetches the price
+                    const url = new URL("https://api.binance.com/api/v3/ticker/price");
+                    url.searchParams.set("symbol", "BTCUSDT");
+                    const data = await fetchJson(url.toString());
+                    const price = Number(data?.price);
+                    if (!Number.isFinite(price) || price <= 0) {
+                        throw new Error("Invalid Binance price payload");
+                    }
+                    // Master's wisdom: Use broadcastAndCollect to ensure consensus across all LIT nodes
+                    const allPrices = await Lit.Actions.broadcastAndCollect({
+                        name: "binancePrice",
+                        value: price.toString(),
+                    });
+                    const prices = allPrices.map((p) => parseFloat(p));
+                    prices.sort((a, b) => a - b);
+                    return prices[Math.floor(prices.length / 2)];
+                },
+                priority: 2,
+            },
+            {
+                name: "Coinbase",
+                fetchPrice: async () => {
+                    // Each node fetches the price
+                    const data = await fetchJson("https://api.coinbase.com/v2/prices/BTC-USD/spot");
+                    const price = Number(data?.data?.amount);
+                    if (!Number.isFinite(price) || price <= 0) {
+                        throw new Error("Invalid Coinbase price payload");
+                    }
+                    // Master's wisdom: Use broadcastAndCollect to ensure consensus across all LIT nodes
+                    const allPrices = await Lit.Actions.broadcastAndCollect({
+                        name: "coinbasePrice",
+                        value: price.toString(),
+                    });
+                    const prices = allPrices.map((p) => parseFloat(p));
+                    prices.sort((a, b) => a - b);
+                    return prices[Math.floor(prices.length / 2)];
+                },
+                priority: 3,
+            },
+        ];
+    }
+    /**
+     * Get BTC price in USD with 8 decimals
+     * Fetches from real price sources in priority order
+     */
+    async getBTCPrice() {
+        console.log(`[Price Oracle] Fetching BTC price from external sources...`);
+        // Try sources in priority order
+        for (const source of this.sources) {
+            try {
+                console.log(`[Price Oracle] Trying ${source.name}...`);
+                const priceUSD = await source.fetchPrice();
+                console.log(`[Price Oracle] ✅ ${source.name}: $${priceUSD.toLocaleString()}`);
+                // Convert to 8 decimals as bigint - DETERMINISTIC METHOD
+                // CRITICAL: Avoid floating-point multiplication which is non-deterministic
+                // across different JavaScript engines/architectures
+                //
+                // Instead of: BigInt(Math.floor(priceUSD * 100_000_000))
+                // Which could give different results on different nodes due to FP precision
+                //
+                // Solution: Convert to integer cents first, then scale using BigInt-only math
+                // Example: $105,447.25 → 10544725 cents → 10544725000000n (8 decimals)
+                const priceCents = Math.round(priceUSD * 100); // Convert to cents (integer)
+                const priceWith8Decimals = BigInt(priceCents) * 1000000n; // Scale to 8 decimals using BigInt
+                console.log(`[Price Oracle] Price with 8 decimals: ${priceWith8Decimals}`);
+                return priceWith8Decimals;
+            }
+            catch (error) {
+                console.warn(`[Price Oracle] ⚠️  ${source.name} failed: ${error.message}`);
+                continue;
+            }
+        }
+        throw new Error("All price sources failed");
+    }
+    /**
+     * Consensus across multiple sources with outlier detection
+     * Returns median price from valid sources after filtering outliers
+     *
+     * Master's Wisdom: Two-Path Validation
+     * 1. If ONE source is outlier (>2% from median) → FILTER it, continue with remaining
+     * 2. If ALL sources too dispersed (>5% spread) → REJECT all, throw error
+     *
+     * Logic Flow:
+     * 1. Calculate initial median from all sources
+     * 2. Filter individual outliers (>2% from median)
+     * 3. If outliers found: remove them, require minimum 2 sources remaining
+     * 4. Recalculate median from valid sources only
+     * 5. Check if remaining sources are too dispersed (max/min ratio > 1.05)
+     * 6. Return final median or throw appropriate error
+     */
+    async getBTCPriceConsensus() {
+        console.log(`[Price Oracle] Fetching BTC price with consensus...`);
+        // Use configured tolerances
+        const OUTLIER_DEVIATION = constants_1.PRICE_ORACLE_OUTLIER_DEVIATION_THRESHOLD; // 2%
+        const DISPERSION_THRESHOLD = constants_1.PRICE_ORACLE_DISPERSION_THRESHOLD; // 5%
+        const results = await Promise.allSettled(this.sources.map(async (source) => {
+            const price = await source.fetchPrice();
+            return { source: source.name, price };
+        }));
+        const successful = results
+            .filter((r) => r.status === "fulfilled")
+            .map((r) => r.value);
+        if (successful.length === 0) {
+            throw new Error("No price sources returned data");
+        }
+        console.log(`[Price Oracle] Got prices from ${successful.length}/${this.sources.length} sources:`);
+        successful.forEach((s) => {
+            console.log(`   ${s.source}: $${s.price.toLocaleString()}`);
+        });
+        // Calculate initial median
+        const prices = successful.map((s) => s.price);
+        prices.sort((a, b) => a - b);
+        const initialMedian = prices[Math.floor(prices.length / 2)];
+        // Check price dispersion FIRST (max/min ratio)
+        // If ALL sources are moderately dispersed, reject before filtering
+        const minPrice = prices[0];
+        const maxPrice = prices[prices.length - 1];
+        const dispersionRatio = maxPrice / minPrice;
+        // Filter outliers (more than PRICE_ORACLE_OUTLIER_DEVIATION_THRESHOLD away from median)
+        const validPrices = successful.filter((s) => {
+            const deviation = Math.abs(s.price - initialMedian) / initialMedian;
+            return deviation <= OUTLIER_DEVIATION;
+        });
+        // If dispersion is high BUT no clear outliers, fail with "too dispersed"
+        if (dispersionRatio > 1 + DISPERSION_THRESHOLD &&
+            validPrices.length === successful.length) {
+            // All prices within outlier threshold but spread too wide
+            throw new Error(`Price consensus failed: sources too dispersed (${((dispersionRatio - 1) *
+                100).toFixed(1)}% spread)`);
+        }
+        // Check if we filtered any outliers
+        if (validPrices.length < successful.length) {
+            const outliers = successful.filter((s) => !validPrices.find((v) => v.source === s.source));
+            console.log(`[Price Oracle] ⚠️  Detected ${outliers.length} outlier(s):`);
+            outliers.forEach((o) => {
+                const deviation = Math.abs(o.price - initialMedian) / initialMedian;
+                console.log(`   ${o.source}: $${o.price.toLocaleString()} (${(deviation * 100).toFixed(1)}% deviation)`);
+            });
+            // Check if we have enough valid sources remaining
+            if (validPrices.length < 2) {
+                throw new Error("Price consensus failed: insufficient valid sources after outlier removal");
+            }
+            console.log(`[Price Oracle] ✅ Outliers filtered, continuing with ${validPrices.length} valid sources`);
+            // Recalculate median with valid prices only
+            const validPricesOnly = validPrices.map((v) => v.price);
+            validPricesOnly.sort((a, b) => a - b);
+            const finalMedian = validPricesOnly[Math.floor(validPricesOnly.length / 2)];
+            console.log(`[Price Oracle] ✅ Consensus price (median): $${finalMedian.toLocaleString()}`);
+            // Convert to 8 decimals as bigint - DETERMINISTIC METHOD
+            const priceCents = Math.round(finalMedian * 100);
+            return BigInt(priceCents) * 1000000n;
+        }
+        // No outliers detected - use initial median
+        console.log(`[Price Oracle] ✅ Consensus price (median): $${initialMedian.toLocaleString()}`);
+        // Convert to 8 decimals as bigint - DETERMINISTIC METHOD
+        const priceCents = Math.round(initialMedian * 100);
+        return BigInt(priceCents) * 1000000n;
+    }
+}
+exports.PriceOracleModule = PriceOracleModule;
+//# sourceMappingURL=price-oracle.module.js.map

package/pkg-dist/src/modules/price-oracle.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price-oracle.module.js","sourceRoot":"","sources":["../../../src/modules/price-oracle.module.ts"],"names":[],"mappings":"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"}

package/pkg-dist/src/modules/protocol-parameters.module.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Protocol Parameters Module
+ *
+ * Fetches protocol parameters directly from smart contracts.
+ * This ensures LIT actions always use current values set by protocol governance.
+ *
+ * Parameters fetched:
+ * - Liquidation threshold (from LoanOperationsManager)
+ * - Term-specific fees (from TermManager)
+ */
+/**
+ * Configuration for protocol parameters module
+ */
+export interface ProtocolParametersConfig {
+    termManagerAddress: string;
+    loanOpsManagerAddress: string;
+    chain: string;
+    chainId: number;
+    rpcUrl?: string;
+}
+/**
+ * Term fees structure
+ */
+export interface TermFees {
+    originationFeeBps: number;
+    extensionFeeBps: number;
+}
+/**
+ * Protocol Parameters Module
+ *
+ * Fetches governance-controlled parameters from smart contracts
+ */
+export declare class ProtocolParametersModule {
+    private termManagerAddress;
+    private loanOpsManagerAddress;
+    private chain;
+    private chainId;
+    private rpcUrl?;
+    constructor(config: ProtocolParametersConfig);
+    /**
+     * Get liquidation threshold from LoanOperationsManager
+     *
+     * @returns Liquidation threshold in basis points
+     */
+    getLiquidationThreshold(): Promise<number>;
+    /**
+     * Get term-specific fees from TermManager
+     *
+     * @param termMonths Loan term in months
+     * @returns Term fees (origination and extension) in basis points
+     */
+    getTermFees(termMonths: number): Promise<TermFees>;
+}
+/**
+ * Factory function to create protocol parameters module
+ */
+export declare function createProtocolParametersModule(config: ProtocolParametersConfig): ProtocolParametersModule;
+//# sourceMappingURL=protocol-parameters.module.d.ts.map

package/pkg-dist/src/modules/protocol-parameters.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-parameters.module.d.ts","sourceRoot":"","sources":["../../../src/modules/protocol-parameters.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,EAAE,wBAAwB;IAQ5C;;;;OAIG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAyChD;;;;;OAKG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAsDzD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,GAC/B,wBAAwB,CAE1B"}