@cubee_ee/sdk 0.5.3 → 0.5.4

package/dist/math/selloff.js

@@ -1,161 +0,0 @@
-"use strict";
-/**
- * Off-chain replicas of the cubic-pool v5 sell-off protections:
- *
- *   - max-selloff sliding window — `math/max_selloff.rs::check_and_advance`
- *   - variable surge-fee curve   — `math/surge_fee.rs::calc_surge_fee_pct`
- *
- * Used by routers/quoters to (a) avoid building routes that would revert
- * with `MaxSelloffExceeded` — the window is a HARD cap on how much of a
- * token can be sold into the pool per window — and (b) quote `amount_out`
- * NET of the surge fee, which is the value the contract checks
- * `minimum_amount_out` against.
- *
- * All arithmetic is bigint and mirrors the contract's u128 intermediates
- * and rounding (cap floored, surge fee rounded UP). `powFp` is the same
- * LogExpMath port the pool uses on-chain.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PERCENT_SCALE = void 0;
-exports.resolveSelloffWindow = resolveSelloffWindow;
-exports.calcSurgeFeePct = calcSurgeFeePct;
-exports.applySurgeFee = applySurgeFee;
-const logExp_1 = require("./logExp");
-/** Scale shared by all `_pct` config fields: 10_000 = 100%. */
-exports.PERCENT_SCALE = 10000n;
-const ONE = 1000000000000000000n;
-/** Convexity base A for the surge curve (contracts: SURGE_FEE_CONVEXITY_FP). */
-const SURGE_FEE_CONVEXITY_FP = 4n * ONE;
-/**
- * Resolve a token's sell-off window state at `nowSecs`, WITHOUT mutating
- * anything — the read-only counterpart of the contract's
- * `check_and_advance` (which the real swap will run).
- *
- * Rotation rules (contract-identical):
- *  - `elapsed >= 2×period` → both buckets aged out; cleared, re-snapshot.
- *  - `elapsed >= period`   → `previous = current`, `current = 0`,
- *    `window_start += period` (slides one period, not to `now`), re-snapshot.
- *  - otherwise             → unchanged; reuse stored snapshot (or capture
- *    the live vb when the snapshot is still `0` / uninitialised).
- */
-function resolveSelloffWindow(input, nowSecs) {
-    const pct = BigInt(input.maxSelloffPct);
-    if (pct === 0n) {
-        return {
-            enabled: false,
-            vbSnapshot: 0n,
-            cap: 0n,
-            effectiveSelloff: 0n,
-            headroom: 0n,
-        };
-    }
-    const period = BigInt(input.periodLengthSecs);
-    if (period <= 0n) {
-        // Unreachable on-chain (set_max_selloff validates period > 0 when
-        // pct > 0); treat defensively as "window accepts nothing".
-        return {
-            enabled: true,
-            vbSnapshot: input.selloffVbSnapshot,
-            cap: 0n,
-            effectiveSelloff: 0n,
-            headroom: 0n,
-        };
-    }
-    const now = BigInt(Math.floor(nowSecs));
-    // Clock skew clamps to 0 rather than rotating backwards.
-    let elapsed = now - input.windowStartTimestamp;
-    if (elapsed < 0n)
-        elapsed = 0n;
-    let previous;
-    let current;
-    let elapsedInWindow;
-    let openedWindow;
-    if (elapsed >= 2n * period) {
-        previous = 0n;
-        current = 0n;
-        elapsedInWindow = 0n;
-        openedWindow = true;
-    }
-    else if (elapsed >= period) {
-        previous = input.currentSelloff;
-        current = 0n;
-        const newWindowStart = input.windowStartTimestamp + period;
-        elapsedInWindow = now - newWindowStart;
-        if (elapsedInWindow < 0n)
-            elapsedInWindow = 0n;
-        openedWindow = true;
-    }
-    else {
-        previous = input.previousSelloff;
-        current = input.currentSelloff;
-        elapsedInWindow = elapsed;
-        openedWindow = false;
-    }
-    const vbSnapshot = openedWindow || input.selloffVbSnapshot === 0n
-        ? input.virtualBalance
-        : input.selloffVbSnapshot;
-    // Cap floored — a user can never sell more than the configured fraction.
-    const cap = (pct * vbSnapshot) / exports.PERCENT_SCALE;
-    const weightedPrev = (previous * (period - elapsedInWindow)) / period;
-    const effectiveSelloff = weightedPrev + current;
-    const headroom = cap > effectiveSelloff ? cap - effectiveSelloff : 0n;
-    return { enabled: true, vbSnapshot, cap, effectiveSelloff, headroom };
-}
-/**
- * Surge-fee percentage (PERCENT_SCALE units, `0..=10_000`) for a swap that
- * pushes the input token's window to `effectiveSelloff` (INCLUDING the
- * swap's own `amount_in`) against `cap`.
- *
- * Curve (contract-identical):
- * ```text
- *   fee(t) = slope_low + (slope_high − slope_low) × (A^t − 1) / (A − 1)
- *   t      = (fill − threshold) / (PERCENT_SCALE − threshold) ∈ [0, 1]
- *   fill   = min(effective × PERCENT_SCALE / cap, PERCENT_SCALE)
- * ```
- * Returns `0` when disabled (`cap == 0`, `slopeHigh == 0`,
- * `threshold >= PERCENT_SCALE`) or fill is at/below the threshold.
- */
-function calcSurgeFeePct(effectiveSelloff, cap, thresholdPct, slopeLowPct, slopeHighPct) {
-    const slopeHigh = BigInt(slopeHighPct);
-    if (cap === 0n || slopeHigh === 0n)
-        return 0n;
-    const thr = BigInt(thresholdPct);
-    if (thr >= exports.PERCENT_SCALE)
-        return 0n;
-    let fill = (effectiveSelloff * exports.PERCENT_SCALE) / cap;
-    if (fill > exports.PERCENT_SCALE)
-        fill = exports.PERCENT_SCALE;
-    if (fill <= thr)
-        return 0n;
-    // Normalized progress t ∈ (0, 1] in 1e18 fixed point.
-    const tFp = ((fill - thr) * ONE) / (exports.PERCENT_SCALE - thr);
-    // A^t ∈ [ONE, A·ONE] via the shared LogExpMath port.
-    const aPowT = (0, logExp_1.powFp)(SURGE_FEE_CONVEXITY_FP, tFp);
-    // factor = (A^t − 1) / (A − 1) ∈ [0, ONE].
-    const aMinusOne = SURGE_FEE_CONVEXITY_FP - ONE;
-    let factor = ((aPowT > ONE ? aPowT - ONE : 0n) * ONE) / aMinusOne;
-    if (factor > ONE)
-        factor = ONE;
-    // surge = slope_low + span × factor, span portion rounded UP.
-    const slopeLow = BigInt(slopeLowPct);
-    const span = slopeHigh > slopeLow ? slopeHigh - slopeLow : 0n;
-    const prod = span * factor;
-    const add = prod / ONE + (prod % ONE !== 0n ? 1n : 0n);
-    const surge = slopeLow + add;
-    return surge > exports.PERCENT_SCALE ? exports.PERCENT_SCALE : surge;
-}
-/**
- * Split a gross curve output into the surge fee and the NET amount the
- * user receives. Fee rounds UP (protective fee never undercharges) and is
- * capped at `amountOut` — mirrors `instructions/user/swap.rs`.
- */
-function applySurgeFee(amountOut, surgeFeePct) {
-    if (surgeFeePct <= 0n || amountOut <= 0n)
-        return { fee: 0n, net: amountOut };
-    const num = amountOut * surgeFeePct;
-    let fee = num / exports.PERCENT_SCALE + (num % exports.PERCENT_SCALE !== 0n ? 1n : 0n);
-    if (fee > amountOut)
-        fee = amountOut;
-    return { fee, net: amountOut - fee };
-}
-//# sourceMappingURL=selloff.js.map

package/dist/math/selloff.js.map

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