@kasufinance/kasu-sdk 2.4.2 → 2.5.0

package/dist/domain/deposit-bounds.d.ts

@@ -0,0 +1,62 @@
+import { TrancheData } from '../services/DataService/types';
+export declare const MIN_LENDING_AMOUNT_FALLBACK = 500;
+export declare const MAX_LENDING_AMOUNT_FALLBACK = 500000;
+export declare function parseTrancheBound(raw: string | number | null | undefined): number | null;
+export interface DepositBounds {
+    minDeposit: number;
+    maxDeposit: number;
+}
+/**
+ * Min + max lending amount (in whole stable units) for a tranche. The max is
+ * clamped by the tranche's *remaining* capacity: a tranche can fill mid-epoch
+ * while `maximumDeposit` stays at its configured value, so without the clamp
+ * a form would accept an amount the contract will reject. Mirrors
+ * kasu-fe-next's `calculateDepositMinMax` (`trancheMax = min(max, capacity)`).
+ */
+export declare function resolveDepositBounds(tranche: TrancheData | undefined): DepositBounds;
+export interface BoundShortcuts {
+    min: number;
+    max: number;
+    enabled: boolean;
+}
+/**
+ * The values a lend form's clickable Min/Max labels write into the amount
+ * field. Derived from the validated bounds but snapped to whole cents
+ * CONSERVATIVELY — the min rounds UP, the max rounds DOWN — so a shortcut can
+ * never fill an amount the form's own `min ≤ amount ≤ max` check rejects, and
+ * never carries the SDK's float noise into the field (`targetDrawAmount -
+ * pendingDeposits` routinely yields `249999.99999999997`, which would make the
+ * label, the field's 2dp display and the signed request label all disagree).
+ *
+ * `enabled` is false when the snapped range is empty: a tranche at capacity
+ * (max clamps to 0 or to sub-cent dust), a remaining capacity below the
+ * tranche minimum, or a jurisdiction floor above the capacity. Nothing either
+ * shortcut could write would validate, so both render inert.
+ */
+export declare function resolveBoundShortcuts(minDeposit: number, maxDeposit: number): BoundShortcuts;
+/**
+ * True when no amount exists that satisfies both bounds — the minimum sits
+ * ABOVE the maximum, so the range a form would otherwise print ("Min 360,000 ·
+ * Max 25,285") is a contradiction, not an instruction. Happens when a
+ * tranche's remaining capacity falls under its own configured minimum, when it
+ * is at capacity (max 0 / sub-cent dust), or when the AU wholesale cumulative
+ * floor lands above the capacity that is left.
+ *
+ * Defined as the negation of `resolveBoundShortcuts().enabled` on purpose: the
+ * "there is nothing to click" and "there is nothing to type" states must never
+ * be able to disagree.
+ *
+ * This is UX only. The binding minimum is enforced by kasu-backend (403
+ * `AU_WHOLESALE_MINIMUM_NOT_MET`) and by the contract's own bounds; nothing
+ * here may be used to relax either.
+ */
+export declare function isBelowMinimumCapacity(minDeposit: number, maxDeposit: number): boolean;
+/**
+ * Largest whole-cent value ≤ `n`. Float multiplication can round `n * 100` UP
+ * onto an integer (`1.15 * 100 === 114.99999999999999` is the usual direction,
+ * but the other happens too), so the result is re-checked against `n` and
+ * stepped down a cent if it overshot — the contract is "never above `n`".
+ */
+export declare function floorToCents(n: number): number;
+/** Smallest whole-cent value ≥ `n`. Mirror of `floorToCents`: never below `n`. */
+export declare function ceilToCents(n: number): number;

package/dist/domain/deposit-bounds.js

@@ -0,0 +1,84 @@
+// Fallbacks if the selected tranche's on-chain min/max are 0 / NaN (some
+// "coming soon" pools haven't been configured yet).
+export const MIN_LENDING_AMOUNT_FALLBACK = 500;
+export const MAX_LENDING_AMOUNT_FALLBACK = 500000;
+export function parseTrancheBound(raw) {
+    if (raw == null)
+        return null;
+    const n = typeof raw === 'string' ? parseFloat(raw) : raw;
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+/**
+ * Min + max lending amount (in whole stable units) for a tranche. The max is
+ * clamped by the tranche's *remaining* capacity: a tranche can fill mid-epoch
+ * while `maximumDeposit` stays at its configured value, so without the clamp
+ * a form would accept an amount the contract will reject. Mirrors
+ * kasu-fe-next's `calculateDepositMinMax` (`trancheMax = min(max, capacity)`).
+ */
+export function resolveDepositBounds(tranche) {
+    var _a, _b;
+    const minDeposit = (_a = parseTrancheBound(tranche === null || tranche === void 0 ? void 0 : tranche.minimumDeposit)) !== null && _a !== void 0 ? _a : MIN_LENDING_AMOUNT_FALLBACK;
+    const configuredMax = (_b = parseTrancheBound(tranche === null || tranche === void 0 ? void 0 : tranche.maximumDeposit)) !== null && _b !== void 0 ? _b : MAX_LENDING_AMOUNT_FALLBACK;
+    if (!tranche)
+        return { minDeposit, maxDeposit: configuredMax };
+    const remainingCapacity = Math.max(0, parseFloat(tranche.poolCapacity) || 0);
+    return { minDeposit, maxDeposit: Math.min(configuredMax, remainingCapacity) };
+}
+/**
+ * The values a lend form's clickable Min/Max labels write into the amount
+ * field. Derived from the validated bounds but snapped to whole cents
+ * CONSERVATIVELY — the min rounds UP, the max rounds DOWN — so a shortcut can
+ * never fill an amount the form's own `min ≤ amount ≤ max` check rejects, and
+ * never carries the SDK's float noise into the field (`targetDrawAmount -
+ * pendingDeposits` routinely yields `249999.99999999997`, which would make the
+ * label, the field's 2dp display and the signed request label all disagree).
+ *
+ * `enabled` is false when the snapped range is empty: a tranche at capacity
+ * (max clamps to 0 or to sub-cent dust), a remaining capacity below the
+ * tranche minimum, or a jurisdiction floor above the capacity. Nothing either
+ * shortcut could write would validate, so both render inert.
+ */
+export function resolveBoundShortcuts(minDeposit, maxDeposit) {
+    const min = ceilToCents(minDeposit);
+    const max = floorToCents(maxDeposit);
+    const enabled = Number.isFinite(min) && Number.isFinite(max) && max > 0 && max >= min;
+    return { min, max, enabled };
+}
+/**
+ * True when no amount exists that satisfies both bounds — the minimum sits
+ * ABOVE the maximum, so the range a form would otherwise print ("Min 360,000 ·
+ * Max 25,285") is a contradiction, not an instruction. Happens when a
+ * tranche's remaining capacity falls under its own configured minimum, when it
+ * is at capacity (max 0 / sub-cent dust), or when the AU wholesale cumulative
+ * floor lands above the capacity that is left.
+ *
+ * Defined as the negation of `resolveBoundShortcuts().enabled` on purpose: the
+ * "there is nothing to click" and "there is nothing to type" states must never
+ * be able to disagree.
+ *
+ * This is UX only. The binding minimum is enforced by kasu-backend (403
+ * `AU_WHOLESALE_MINIMUM_NOT_MET`) and by the contract's own bounds; nothing
+ * here may be used to relax either.
+ */
+export function isBelowMinimumCapacity(minDeposit, maxDeposit) {
+    return !resolveBoundShortcuts(minDeposit, maxDeposit).enabled;
+}
+const CENTS = 100;
+/**
+ * Largest whole-cent value ≤ `n`. Float multiplication can round `n * 100` UP
+ * onto an integer (`1.15 * 100 === 114.99999999999999` is the usual direction,
+ * but the other happens too), so the result is re-checked against `n` and
+ * stepped down a cent if it overshot — the contract is "never above `n`".
+ */
+export function floorToCents(n) {
+    const k = Math.floor(n * CENTS);
+    const snapped = k / CENTS;
+    return snapped > n ? (k - 1) / CENTS : snapped;
+}
+/** Smallest whole-cent value ≥ `n`. Mirror of `floorToCents`: never below `n`. */
+export function ceilToCents(n) {
+    const k = Math.ceil(n * CENTS);
+    const snapped = k / CENTS;
+    return snapped < n ? (k + 1) / CENTS : snapped;
+}
+//# sourceMappingURL=deposit-bounds.js.map

package/dist/domain/deposit-bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit-bounds.js","sourceRoot":"","sources":["../../src/domain/deposit-bounds.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,oDAAoD;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAC/C,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAO,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAC7B,GAAuC;IAEvC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1D,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAAgC;;IAEhC,MAAM,UAAU,GACZ,MAAA,iBAAiB,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,CAAC,mCAC1C,2BAA2B,CAAC;IAChC,MAAM,aAAa,GACf,MAAA,iBAAiB,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,cAAc,CAAC,mCAC1C,2BAA2B,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IAC/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAC9B,CAAC,EACD,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CACxC,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE,CAAC;AAClF,CAAC;AAQD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACjC,UAAkB,EAClB,UAAkB;IAElB,MAAM,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,OAAO,GACT,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;IAC1E,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAClC,UAAkB,EAClB,UAAkB;IAElB,OAAO,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC;AAClE,CAAC;AAED,MAAM,KAAK,GAAG,GAAG,CAAC;AAElB;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,CAAS;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACnD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,CAAS;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACnD,CAAC"}

package/dist/domain/deposit-bounds.test.js

@@ -0,0 +1,135 @@
+import * as fc from 'fast-check';
+import { ceilToCents, floorToCents, isBelowMinimumCapacity, MAX_LENDING_AMOUNT_FALLBACK, MIN_LENDING_AMOUNT_FALLBACK, parseTrancheBound, resolveBoundShortcuts, resolveDepositBounds, } from './deposit-bounds';
+/**
+ * Ported from kasu-ui `src/features/lending/lib/tranche-bounds.property.test.ts`,
+ * with the `resolveDepositBounds` / `parseTrancheBound` cases the property file
+ * did not cover.
+ *
+ * The Min/Max shortcuts (clickable bound labels on a lend form) must never
+ * write an amount the form rejects, so the snapping is checked as invariants
+ * over the whole input domain rather than at a few hand-picked values.
+ */
+function tranche(over) {
+    return Object.assign({ minimumDeposit: '500', maximumDeposit: '500000', poolCapacity: '250000' }, over);
+}
+const amountArb = fc.double({
+    min: 0,
+    max: 1e12,
+    noNaN: true,
+    noDefaultInfinity: true,
+});
+/** `String(k / 100)` prints at most two decimals for any integer `k` in range. */
+const AT_MOST_TWO_DP = /^\d+(\.\d{1,2})?$/;
+describe('parseTrancheBound', () => {
+    it('accepts a positive finite bound from a string or a number', () => {
+        expect(parseTrancheBound('500')).toBe(500);
+        expect(parseTrancheBound(500)).toBe(500);
+    });
+    it('rejects anything that is not a usable bound', () => {
+        expect(parseTrancheBound(null)).toBeNull();
+        expect(parseTrancheBound(undefined)).toBeNull();
+        expect(parseTrancheBound('')).toBeNull();
+        expect(parseTrancheBound('0')).toBeNull();
+        expect(parseTrancheBound('-1')).toBeNull();
+        expect(parseTrancheBound('not-a-number')).toBeNull();
+        expect(parseTrancheBound(Infinity)).toBeNull();
+    });
+});
+describe('resolveDepositBounds', () => {
+    it('clamps the max by the tranche’s REMAINING capacity', () => {
+        // A tranche can fill mid-epoch while `maximumDeposit` stays put.
+        expect(resolveDepositBounds(tranche({ maximumDeposit: '500000', poolCapacity: '25285.86' }))).toEqual({ minDeposit: 500, maxDeposit: 25285.86 });
+    });
+    it('keeps the configured max when capacity is larger', () => {
+        expect(resolveDepositBounds(tranche({ maximumDeposit: '500000', poolCapacity: '900000' }))).toEqual({ minDeposit: 500, maxDeposit: 500000 });
+    });
+    it('falls back when a "coming soon" pool has no bounds configured', () => {
+        expect(resolveDepositBounds(tranche({
+            minimumDeposit: '0',
+            maximumDeposit: '0',
+            poolCapacity: '900000',
+        }))).toEqual({
+            minDeposit: MIN_LENDING_AMOUNT_FALLBACK,
+            maxDeposit: MAX_LENDING_AMOUNT_FALLBACK,
+        });
+    });
+    it('uses both fallbacks and skips the capacity clamp with no tranche at all', () => {
+        expect(resolveDepositBounds(undefined)).toEqual({
+            minDeposit: MIN_LENDING_AMOUNT_FALLBACK,
+            maxDeposit: MAX_LENDING_AMOUNT_FALLBACK,
+        });
+    });
+    it('treats unparseable or negative capacity as zero', () => {
+        expect(resolveDepositBounds(tranche({ poolCapacity: 'not-a-number' }))
+            .maxDeposit).toBe(0);
+        expect(resolveDepositBounds(tranche({ poolCapacity: '-5' })).maxDeposit).toBe(0);
+    });
+});
+describe('cent snapping', () => {
+    it('floorToCents never exceeds its input, stays within a cent of it, and has ≤ 2dp', () => {
+        fc.assert(fc.property(amountArb, (n) => {
+            const snapped = floorToCents(n);
+            expect(snapped).toBeLessThanOrEqual(n);
+            expect(n - snapped).toBeLessThan(0.02);
+            expect(String(snapped)).toMatch(AT_MOST_TWO_DP);
+        }));
+    });
+    it('ceilToCents never undershoots its input, stays within a cent of it, and has ≤ 2dp', () => {
+        fc.assert(fc.property(amountArb, (n) => {
+            const snapped = ceilToCents(n);
+            expect(snapped).toBeGreaterThanOrEqual(n);
+            expect(snapped - n).toBeLessThan(0.02);
+            expect(String(snapped)).toMatch(AT_MOST_TWO_DP);
+        }));
+    });
+});
+describe('resolveBoundShortcuts', () => {
+    it('keeps both shortcuts inside the validated range whenever they are enabled', () => {
+        fc.assert(fc.property(amountArb, amountArb, (minDeposit, maxDeposit) => {
+            const { min, max, enabled } = resolveBoundShortcuts(minDeposit, maxDeposit);
+            if (!enabled)
+                return;
+            expect(min).toBeGreaterThanOrEqual(minDeposit);
+            expect(max).toBeLessThanOrEqual(maxDeposit);
+            expect(max).toBeGreaterThanOrEqual(min);
+            expect(max).toBeGreaterThan(0);
+        }));
+    });
+    it('disables the pair whenever the snapped range is empty', () => {
+        // Tranche at capacity (max clamps to 0), sub-cent dust the SDK's float
+        // subtraction leaves behind, remaining capacity below the tranche
+        // minimum, and an AU floor above the capacity.
+        expect(resolveBoundShortcuts(500, 0).enabled).toBe(false);
+        expect(resolveBoundShortcuts(500, 1.4551915228366852e-11).enabled).toBe(false);
+        expect(resolveBoundShortcuts(500, 137).enabled).toBe(false);
+        expect(resolveBoundShortcuts(240000, 100000).enabled).toBe(false);
+    });
+    it('snaps SDK float noise onto cents without crossing the bound', () => {
+        expect(resolveBoundShortcuts(500, 249999.99999999997)).toEqual({
+            min: 500,
+            max: 249999.99,
+            enabled: true,
+        });
+        expect(resolveBoundShortcuts(500, 25285.86)).toEqual({
+            min: 500,
+            max: 25285.86,
+            enabled: true,
+        });
+        // An AU remainder with more precision than the field shows rounds UP.
+        expect(resolveBoundShortcuts(358765.432109, 500000).min).toBe(358765.44);
+    });
+});
+describe('isBelowMinimumCapacity', () => {
+    it('is exactly the negation of the shortcuts being enabled', () => {
+        fc.assert(fc.property(amountArb, amountArb, (minDeposit, maxDeposit) => {
+            // The "nothing to click" and "nothing to type" states must
+            // never be able to disagree.
+            expect(isBelowMinimumCapacity(minDeposit, maxDeposit)).toBe(!resolveBoundShortcuts(minDeposit, maxDeposit).enabled);
+        }));
+    });
+    it('flags a capacity that has fallen under the tranche minimum', () => {
+        expect(isBelowMinimumCapacity(500, 137)).toBe(true);
+        expect(isBelowMinimumCapacity(500, 25285.86)).toBe(false);
+    });
+});
+//# sourceMappingURL=deposit-bounds.test.js.map

package/dist/domain/deposit-bounds.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit-bounds.test.js","sourceRoot":"","sources":["../../src/domain/deposit-bounds.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAIjC,OAAO,EACH,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;GAQG;AAEH,SAAS,OAAO,CAAC,IAA0B;IACvC,OAAO,gBACH,cAAc,EAAE,KAAK,EACrB,cAAc,EAAE,QAAQ,EACxB,YAAY,EAAE,QAAQ,IACnB,IAAI,CACgB,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,EAAE,CAAC,MAAM,CAAC;IACxB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,iBAAiB,EAAE,IAAI;CAC1B,CAAC,CAAC;AACH,kFAAkF;AAClF,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChD,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACrD,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,iEAAiE;QACjE,MAAM,CACF,oBAAoB,CAChB,OAAO,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAClE,CACJ,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QACxD,MAAM,CACF,oBAAoB,CAChB,OAAO,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAChE,CACJ,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACrE,MAAM,CACF,oBAAoB,CAChB,OAAO,CAAC;YACJ,cAAc,EAAE,GAAG;YACnB,cAAc,EAAE,GAAG;YACnB,YAAY,EAAE,QAAQ;SACzB,CAAC,CACL,CACJ,CAAC,OAAO,CAAC;YACN,UAAU,EAAE,2BAA2B;YACvC,UAAU,EAAE,2BAA2B;SAC1C,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5C,UAAU,EAAE,2BAA2B;YACvC,UAAU,EAAE,2BAA2B;SAC1C,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,CACF,oBAAoB,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;aAC1D,UAAU,CAClB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,MAAM,CACF,oBAAoB,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CACnE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACtF,EAAE,CAAC,MAAM,CACL,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC,CAAC,CACL,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QACzF,EAAE,CAAC,MAAM,CACL,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC,CAAC,CACL,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACjF,EAAE,CAAC,MAAM,CACL,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE;YACzD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAC/C,UAAU,EACV,UAAU,CACb,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,MAAM,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CACL,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,uEAAuE;QACvE,kEAAkE;QAClE,+CAA+C;QAC/C,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,CACF,qBAAqB,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC,OAAO,CAC7D,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,qBAAqB,CAAC,MAAO,EAAE,MAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3D,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,SAAS;YACd,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACjD,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,sEAAsE;QACtE,MAAM,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAC1D,SAAS,CACZ,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAC9D,EAAE,CAAC,MAAM,CACL,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE;YACzD,2DAA2D;YAC3D,6BAA6B;YAC7B,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CACvD,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,OAAO,CACzD,CAAC;QACN,CAAC,CAAC,CACL,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,sBAAsB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/domain/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The shared domain layer: the rules every Kasu frontend needs to agree on,
+ * in one place instead of three.
+ *
+ * Two rules govern what may live here.
+ *
+ * 1. **Numbers and codes only.** No copy, no locale, no `Intl`, no string a
+ *    user reads — `netEffectiveApy` returns `0.196`, never `'19.60% p.a.'`,
+ *    and `derivePoolStatus` returns the code `'Full'`, not a sentence. The
+ *    formatters that turn these into text stay in each app, where the design
+ *    system and the visitor's locale are. The one exception is
+ *    `getTrancheDisplayName`, which exists precisely because that rename must
+ *    NOT drift between apps.
+ * 2. **Pure.** No network, no clock, no environment. Anything with I/O belongs
+ *    in `facade/` (see `fetchUnusedPoolIds`).
+ */
+export { apyToEpochRate, epochRateToApy, EPOCHS_IN_YEAR, netEffectiveApy, } from './rates';
+export { ceilToCents, floorToCents, isBelowMinimumCapacity, MAX_LENDING_AMOUNT_FALLBACK, MIN_LENDING_AMOUNT_FALLBACK, parseTrancheBound, resolveBoundShortcuts, resolveDepositBounds, } from './deposit-bounds';
+export type { BoundShortcuts, DepositBounds } from './deposit-bounds';
+export { APXIUM, getCreditOriginator, getInstitutionalLender, INVOICEMATE, RIXON_CAPITAL, } from './partners';
+export type { PoolNameSignal, StrategyPartner } from './partners';
+export { maxNetRateCeiling, pickHighestYieldTranche, poolMaxApy, selectVisiblePools, } from './pools';
+export type { BestTranche } from './pools';
+export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
+export { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
+export type { ApyBounds, PoolStatus, TrancheCapacitySignal, } from './tranches';

package/dist/domain/index.js

@@ -0,0 +1,23 @@
+/**
+ * The shared domain layer: the rules every Kasu frontend needs to agree on,
+ * in one place instead of three.
+ *
+ * Two rules govern what may live here.
+ *
+ * 1. **Numbers and codes only.** No copy, no locale, no `Intl`, no string a
+ *    user reads — `netEffectiveApy` returns `0.196`, never `'19.60% p.a.'`,
+ *    and `derivePoolStatus` returns the code `'Full'`, not a sentence. The
+ *    formatters that turn these into text stay in each app, where the design
+ *    system and the visitor's locale are. The one exception is
+ *    `getTrancheDisplayName`, which exists precisely because that rename must
+ *    NOT drift between apps.
+ * 2. **Pure.** No network, no clock, no environment. Anything with I/O belongs
+ *    in `facade/` (see `fetchUnusedPoolIds`).
+ */
+export { apyToEpochRate, epochRateToApy, EPOCHS_IN_YEAR, netEffectiveApy, } from './rates';
+export { ceilToCents, floorToCents, isBelowMinimumCapacity, MAX_LENDING_AMOUNT_FALLBACK, MIN_LENDING_AMOUNT_FALLBACK, parseTrancheBound, resolveBoundShortcuts, resolveDepositBounds, } from './deposit-bounds';
+export { APXIUM, getCreditOriginator, getInstitutionalLender, INVOICEMATE, RIXON_CAPITAL, } from './partners';
+export { maxNetRateCeiling, pickHighestYieldTranche, poolMaxApy, selectVisiblePools, } from './pools';
+export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
+export { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACH,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACH,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC3B,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACH,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,aAAa,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,EACH,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,GAClB,MAAM,YAAY,CAAC"}

package/dist/domain/partners.d.ts

@@ -0,0 +1,34 @@
+export interface StrategyPartner {
+    name: string;
+    url: string;
+}
+export declare const APXIUM: StrategyPartner;
+export declare const INVOICEMATE: StrategyPartner;
+export declare const RIXON_CAPITAL: StrategyPartner;
+/**
+ * Anything a pool name can arrive as. The raw `PoolOverview` carries
+ * `poolName`, the facade's `Strategy` carries `name`, and a caller who already
+ * has the string can pass it directly — one rule, whichever shape reaches it.
+ * `poolName` wins when an object carries both and it is set.
+ */
+export type PoolNameSignal = string | {
+    poolName?: string | null;
+} | {
+    name?: string | null;
+};
+/**
+ * Credit-originator inference by pool NAME only. The sole InvoiceMate
+ * strategy is "Payment Finance (PayFi)" (matched by "payfi" / "payment
+ * finance"); every other pool — Whole Ledger / Taxation / Professional Fee
+ * Funding — is Apxium.
+ *
+ * We deliberately do NOT match on asset class / subheading: Apxium's pools
+ * are receivables/invoice financing, so their asset class contains
+ * "invoice" and would be misclassified as InvoiceMate.
+ */
+export declare function getCreditOriginator(pool: PoolNameSignal): StrategyPartner;
+/**
+ * Apxium pools carry an institutional senior lender (Rixon Capital);
+ * InvoiceMate pools have none.
+ */
+export declare function getInstitutionalLender(originator: StrategyPartner): StrategyPartner | null;

package/dist/domain/partners.js

@@ -0,0 +1,43 @@
+export const APXIUM = {
+    name: 'Apxium',
+    url: 'https://www.apxium.com/',
+};
+export const INVOICEMATE = {
+    name: 'InvoiceMate',
+    url: 'https://invoicemate.net/',
+};
+export const RIXON_CAPITAL = {
+    name: 'Rixon Capital',
+    url: 'https://rixon.capital/',
+};
+function poolNameOf(pool) {
+    var _a, _b;
+    if (typeof pool === 'string')
+        return pool;
+    const signal = pool;
+    return (_b = (_a = signal.poolName) !== null && _a !== void 0 ? _a : signal.name) !== null && _b !== void 0 ? _b : '';
+}
+/**
+ * Credit-originator inference by pool NAME only. The sole InvoiceMate
+ * strategy is "Payment Finance (PayFi)" (matched by "payfi" / "payment
+ * finance"); every other pool — Whole Ledger / Taxation / Professional Fee
+ * Funding — is Apxium.
+ *
+ * We deliberately do NOT match on asset class / subheading: Apxium's pools
+ * are receivables/invoice financing, so their asset class contains
+ * "invoice" and would be misclassified as InvoiceMate.
+ */
+export function getCreditOriginator(pool) {
+    const name = poolNameOf(pool).toLowerCase();
+    if (/payfi|payment finance/.test(name))
+        return INVOICEMATE;
+    return APXIUM;
+}
+/**
+ * Apxium pools carry an institutional senior lender (Rixon Capital);
+ * InvoiceMate pools have none.
+ */
+export function getInstitutionalLender(originator) {
+    return originator.name === APXIUM.name ? RIXON_CAPITAL : null;
+}
+//# sourceMappingURL=partners.js.map

package/dist/domain/partners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partners.js","sourceRoot":"","sources":["../../src/domain/partners.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,MAAM,GAAoB;IACnC,IAAI,EAAE,QAAQ;IACd,GAAG,EAAE,yBAAyB;CACjC,CAAC;AACF,MAAM,CAAC,MAAM,WAAW,GAAoB;IACxC,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,0BAA0B;CAClC,CAAC;AACF,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC1C,IAAI,EAAE,eAAe;IACrB,GAAG,EAAE,wBAAwB;CAChC,CAAC;AAaF,SAAS,UAAU,CAAC,IAAoB;;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAuD,IAAI,CAAC;IACxE,OAAO,MAAA,MAAA,MAAM,CAAC,QAAQ,mCAAI,MAAM,CAAC,IAAI,mCAAI,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoB;IACpD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC;IAC3D,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAClC,UAA2B;IAE3B,OAAO,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC"}

package/dist/domain/partners.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain/partners.test.js

@@ -0,0 +1,53 @@
+import { APXIUM, getCreditOriginator, getInstitutionalLender, INVOICEMATE, RIXON_CAPITAL, } from './partners';
+// Ported from kasu-ui `src/features/lending/lib/strategy-partners.test.ts`.
+describe('getCreditOriginator', () => {
+    it('maps "Payment Finance (PayFi)" to InvoiceMate', () => {
+        expect(getCreditOriginator({ poolName: 'Payment Finance (PayFi)' })).toBe(INVOICEMATE);
+    });
+    it('keeps Apxium receivables pools as Apxium (regression: do not match "invoice")', () => {
+        // The bug: matching the asset class ("invoice financing") wrongly
+        // classified Apxium receivables pools as InvoiceMate. Name-only
+        // matching fixes it — none of these names contain payfi/payment
+        // finance.
+        expect(getCreditOriginator({ poolName: 'Professional Fee Funding' })).toBe(APXIUM);
+        expect(getCreditOriginator({ poolName: 'Whole Ledger Funding' })).toBe(APXIUM);
+        expect(getCreditOriginator({ poolName: 'Taxation Funding (Tax Pay)' })).toBe(APXIUM);
+    });
+    it('is case-insensitive and matches the "payfi" / "payment finance" name', () => {
+        expect(getCreditOriginator({ poolName: 'payment finance' })).toBe(INVOICEMATE);
+        expect(getCreditOriginator({ poolName: 'PAYFI Strategy' })).toBe(INVOICEMATE);
+    });
+    it('defaults to Apxium for empty / missing names', () => {
+        expect(getCreditOriginator({ poolName: '' })).toBe(APXIUM);
+        expect(getCreditOriginator({})).toBe(APXIUM);
+    });
+});
+describe('getCreditOriginator — the widened PoolNameSignal', () => {
+    it('reads the facade Strategy shape (`name`)', () => {
+        expect(getCreditOriginator({ name: 'Payment Finance (PayFi)' })).toBe(INVOICEMATE);
+        expect(getCreditOriginator({ name: 'Taxation Funding' })).toBe(APXIUM);
+        expect(getCreditOriginator({ name: null })).toBe(APXIUM);
+    });
+    it('reads a bare string', () => {
+        expect(getCreditOriginator('Payment Finance (PayFi)')).toBe(INVOICEMATE);
+        expect(getCreditOriginator('Whole Ledger Funding')).toBe(APXIUM);
+        expect(getCreditOriginator('')).toBe(APXIUM);
+    });
+    it('prefers poolName when an object carries both', () => {
+        const both = { poolName: 'Taxation Funding', name: 'Payment Finance' };
+        expect(getCreditOriginator(both)).toBe(APXIUM);
+    });
+    it('treats an explicitly null poolName as missing, not as a match', () => {
+        expect(getCreditOriginator({ poolName: null })).toBe(APXIUM);
+        expect(getCreditOriginator({ poolName: undefined })).toBe(APXIUM);
+    });
+});
+describe('getInstitutionalLender', () => {
+    it('gives Apxium pools Rixon Capital', () => {
+        expect(getInstitutionalLender(APXIUM)).toBe(RIXON_CAPITAL);
+    });
+    it('gives InvoiceMate pools no senior lender', () => {
+        expect(getInstitutionalLender(INVOICEMATE)).toBeNull();
+    });
+});
+//# sourceMappingURL=partners.test.js.map

package/dist/domain/partners.test.js.map

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

package/dist/domain/pools.d.ts

@@ -0,0 +1,70 @@
+import { PoolOverview, TrancheData } from '../services/DataService/types';
+/**
+ * The highest FTD-inclusive upper bound across a pool's tranches, or `0` when
+ * none is usable. The sort key behind `selectVisiblePools`.
+ */
+export declare function poolMaxApy(pool: PoolOverview): number;
+/**
+ * A lending grid's visible pool set: *active* and *not yet oversubscribed*
+ * pools, sorted with has-capacity strategies first, then by highest max APY.
+ *
+ * Shared so a server-rendered payload and a client re-fetch can never
+ * disagree — kasu-ui's SSR fetcher and client hook used to carry verbatim
+ * copies of this filter + sort, and any drift surfaced as an SSR→CSR content
+ * flip on the lending page.
+ *
+ * Pure: operates on a fresh array (`filter` output), so the in-place `sort`
+ * does not mutate the caller's input.
+ */
+export declare function selectVisiblePools(all: PoolOverview[]): PoolOverview[];
+export interface BestTranche {
+    pool: PoolOverview;
+    tranche: TrancheData;
+    /** Base variable-rate APY as a decimal fraction (e.g. `0.12`). */
+    apy: number;
+}
+/**
+ * The highest-yielding tranche that still has capacity, across all pools.
+ *
+ * Compares `tranche.apy` — the base variable rate — NOT `minApy`/`maxApy`,
+ * which the data service widens with fixed-term-deposit variants. A headline
+ * naming one tranche should advertise the rate every depositor gets, not an
+ * FTD-locked uplift.
+ *
+ * Capacity is gated by the shared `trancheHasCapacity` (≥ 1 stable unit), so
+ * full tranches never win. Ties on APY break toward more remaining capacity.
+ * Returns `null` when no tranche qualifies (empty list, all full, or all rates
+ * unset) — callers fall back to static copy.
+ */
+export declare function pickHighestYieldTranche(pools?: PoolOverview[] | null): BestTranche | null;
+/**
+ * The highest NET Effective Interest Rate on offer across the pools passed in
+ * — the ceiling behind an "up to …" claim. The numeric core of kasu-ui's
+ * `formatMaxNetRate`.
+ *
+ * `null` when there is nothing to quote, and callers must then DROP the claim
+ * rather than print a placeholder: this feeds text that gets posted publicly.
+ *
+ * Scope follows the caller's pool list, which is normally keyed to one chain —
+ * so a lender on XDC AUDD quotes the AUDD ceiling, not Base's. That is the
+ * intended reading: they are sharing the deployment they are on.
+ *
+ * Reads `maxApy` — the FTD-inclusive upper bound — unlike
+ * `pickHighestYieldTranche` above, which names one tranche's variable rate. A
+ * ceiling claim and a specific tranche's rate are different statements, and
+ * the ceiling must agree with the top of `netTrancheApyBounds`, which reads
+ * the same field. `apy` is taken into the comparison too: `maxApy` is derived
+ * from the base rate plus any fixed-term configs, so it can never be lower,
+ * and a tranche that carries no `maxApy` at all still contributes its base
+ * rate instead of dropping out.
+ *
+ * Capacity-gated by `trancheHasCapacity` — we never advertise a rate no lender
+ * could take up.
+ *
+ * FAIL CLOSED: an out-of-domain fee, or a net rate that is non-finite or ≤ 0,
+ * returns `null`. The gross figure is never a substitute, and a caller that
+ * does not yet know the fee must not pass `0`.
+ *
+ * @param feePercent the chain's performance fee, 0..100 — never a fraction.
+ */
+export declare function maxNetRateCeiling(pools: PoolOverview[] | undefined | null, feePercent: number): number | null;