@kasufinance/kasu-sdk 2.4.2 → 2.6.0

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.d.ts

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

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":"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"}

package/dist/domain/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ *
+ *    Two kinds of string are exempt, and only these two. `getTrancheDisplayName`
+ *    is here precisely because that rename must NOT drift between apps. And
+ *    `loan-contract.ts` builds PROTOCOL strings — messages kasu-backend
+ *    reconstructs byte-for-byte to verify a lender's signature. Those are not
+ *    copy: nobody may reword them, in any language, without a matching backend
+ *    change, which is exactly why they belong in one place.
+ * 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 { AU_ALPHA3, AU_MIN_CUMULATIVE_BY_STABLE, auMinimumRemaining, auThresholdFor, isAuMinimumExempt, isAustralianKyc, parseMinorUnits, } from './au-minimum';
+export type { AuMinimumInput } from './au-minimum';
+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 { asContractType, buildContractVersionType, buildFullNameRequestMessage, buildLegacyContractRequestMessage, buildLoanAgreementSignMessage, encodeDepositData, formatSignTimestampUtc, parseFormattedMessage, } from './loan-contract';
+export type { ContractListItem, ContractSection, ContractType, ExemptLoanContract, GenerateContractResponse, LoanContractFormatted, ResolvedContractResponse, RetailLoanContract, } from './loan-contract';
+export { maxNetRateCeiling, pickHighestYieldTranche, poolMaxApy, selectVisiblePools, } from './pools';
+export type { BestTranche } from './pools';
+export { countSubmissions, deriveRequestState, firstSubmissionTimestamp, isCycleClosed, submissionEvents, } from './requests';
+export type { RequestKind, RequestState, RequestStatusCode, } from './requests';
+export { CLEARING_WINDOW_SECONDS, computeSettlementWindow, deriveCycleDates, nextCycleBoundary, } from './settlement';
+export type { CycleDates, SettlementWindowInput, SettlementWindowState, } from './settlement';
+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';
+export { isUnpredictableGas, isUserRejected } from './wallet-errors';

package/dist/domain/index.js

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ *
+ *    Two kinds of string are exempt, and only these two. `getTrancheDisplayName`
+ *    is here precisely because that rename must NOT drift between apps. And
+ *    `loan-contract.ts` builds PROTOCOL strings — messages kasu-backend
+ *    reconstructs byte-for-byte to verify a lender's signature. Those are not
+ *    copy: nobody may reword them, in any language, without a matching backend
+ *    change, which is exactly why they belong in one place.
+ * 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 { AU_ALPHA3, AU_MIN_CUMULATIVE_BY_STABLE, auMinimumRemaining, auThresholdFor, isAuMinimumExempt, isAustralianKyc, parseMinorUnits, } from './au-minimum';
+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 { asContractType, buildContractVersionType, buildFullNameRequestMessage, buildLegacyContractRequestMessage, buildLoanAgreementSignMessage, encodeDepositData, formatSignTimestampUtc, parseFormattedMessage, } from './loan-contract';
+export { maxNetRateCeiling, pickHighestYieldTranche, poolMaxApy, selectVisiblePools, } from './pools';
+export { countSubmissions, deriveRequestState, firstSubmissionTimestamp, isCycleClosed, submissionEvents, } from './requests';
+export { CLEARING_WINDOW_SECONDS, computeSettlementWindow, deriveCycleDates, nextCycleBoundary, } from './settlement';
+export { getTrancheDisplayName, UPPER_MEZZANINE } from './tranche-display-name';
+export { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
+export { isUnpredictableGas, isUserRejected } from './wallet-errors';
+//# 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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EACH,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACH,SAAS,EACT,2BAA2B,EAC3B,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,GAClB,MAAM,cAAc,CAAC;AAGtB,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,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,iCAAiC,EACjC,6BAA6B,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACxB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,EACH,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,kBAAkB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACH,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,GACnB,MAAM,YAAY,CAAC;AAOpB,OAAO,EACH,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,cAAc,CAAC;AAOtB,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;AAOpB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/domain/loan-contract.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Loan-contract protocol: the strings and the bytes kasu-backend verifies.
+ *
+ * ⚠️ THE ONE EXCEPTION TO "NUMBERS AND CODES ONLY". Everything this module
+ * returns as a string is a PROTOCOL string, not copy. The backend reconstructs
+ * each of these messages byte-for-byte and verifies the lender's signature
+ * against it; a changed word, separator, line break or date format does not
+ * read differently — it stops every signature verifying. They are here, in the
+ * shared layer, for exactly the reason `getTrancheDisplayName` is: so the
+ * applications cannot drift apart on them.
+ *
+ * Any change to a builder below is a coordinated multi-repo change that has to
+ * land in kasu-backend at the same moment. Do not "tidy" this file.
+ *
+ * Lifted from kasu-ui's `features/lending/lib/{contract-types, sign-message}.ts`
+ * and `encode-deposit-data.ts` — the last rewritten from viem to ethers v5
+ * (kasu-mobile already runs that port; the tests pin the two byte-identical).
+ */
+/** Recursive list nesting: `list-N-list`, etc. — indexed by string keys. */
+export type ContractListItem = {
+    label?: string;
+    description?: string;
+} & Record<string, unknown>;
+export type ContractSection = {
+    title?: string;
+    description?: string;
+} & Record<`list-${number}`, ContractListItem | undefined> & Record<string, unknown>;
+export type RetailLoanContract = {
+    important?: {
+        title?: string;
+        description?: string;
+    };
+    intro?: string;
+    between?: string;
+    parties?: ContractSection;
+    background?: ContractSection;
+    witnesses?: ContractSection;
+} & Record<`subheader-${number}`, ContractSection | undefined> & Record<string, unknown>;
+/**
+ * The exempt (wholesale) contract renders from the same tree as the retail
+ * one; the templates differ, the SHAPE does not. Kept as its own name because
+ * `contractType` distinguishes them everywhere else.
+ */
+export type ExemptLoanContract = RetailLoanContract;
+/** Either contract, parsed. Both are the same tree. */
+export type LoanContractFormatted = RetailLoanContract;
+/**
+ * `contractType` arrives over the wire as a free string; these are the two the
+ * version byte encodes.
+ */
+export type ContractType = 'retail' | 'exempt';
+export interface GenerateContractResponse {
+    fullName: string;
+    /** The plaintext the lender signs (EIP-191). */
+    contractMessage: string;
+    /** Returned as a JSON-encoded string; parse before rendering. */
+    formattedMessage: string;
+    contractType: ContractType;
+    /** Template version (>= 1). */
+    contractVersion: number;
+    /** ms-epoch; feeds the on-chain `depositData` and the TTL guard. */
+    timestamp: number;
+}
+export type ResolvedContractResponse = GenerateContractResponse & {
+    isValid: boolean;
+};
+/** Narrow the backend's loose `contractType` string to the encoded union. */
+export declare function asContractType(raw: string): ContractType;
+/**
+ * Parse the server's JSON-string `formattedMessage` into a tree. Returns
+ * `null` on parse failure so a renderer can fall back to the plaintext.
+ */
+export declare function parseFormattedMessage(raw: string): LoanContractFormatted | null;
+/**
+ * Pack the contract version and type into the `versionType` word.
+ *
+ * ```
+ * high byte = contract version (>= 1)
+ * low byte  = 0 for retail, 1 for exempt
+ * ```
+ */
+export declare function buildContractVersionType(contractVersion: number, contractType: ContractType): number;
+/**
+ * Build the on-chain `depositData` blob that `requestDepositWithKyc` expects.
+ *
+ * The KasuController decodes the bytes as
+ * `(bytes signature, uint256 timestamp, uint256 versionType)` and uses the
+ * embedded acceptance signature to verify — retrospectively, via the
+ * agreements service `/contract/resolve` — that the lender signed the
+ * loan-contract text. The ABI tuple and the packing are consensus-critical:
+ * these bytes go on chain.
+ *
+ * kasu-ui encodes this with viem, kasu-mobile with ethers v5 (viem is not
+ * available on Expo). This is the ethers v5 implementation, and
+ * `loan-contract.test.ts` pins its output byte-for-byte against fixtures
+ * produced by the viem version, so the two apps can never diverge here.
+ *
+ * @param args.signature EIP-191 signature from the lender accepting
+ *   `contractMessage`, as a 0x-prefixed hex string.
+ * @param args.timestamp ms-epoch from the contract response.
+ */
+export declare function encodeDepositData(args: {
+    signature: string;
+    timestamp: number;
+    contractVersion: number;
+    contractType: ContractType;
+}): string;
+/**
+ * Format a unix timestamp as `{day} {MonthName} {yyyy}, {HH}:{mm}` in UTC.
+ * Day is non-padded; hour and minute are zero-padded to two digits (24h). A
+ * timestamp with >= 13 digits is treated as milliseconds, otherwise as seconds
+ * — the same auto-detection kasu-backend applies.
+ *
+ * Deliberately a manual formatter with English month names: no locale, no
+ * `Intl`, so the output is byte-identical across runtimes and time zones. This
+ * is not a display date. It goes inside a signed message.
+ *
+ * e.g. 1785313320000 → `"29 July 2026, 08:22"`
+ */
+export declare function formatSignTimestampUtc(timestamp: number): string;
+/**
+ * The 4-line human-readable message a lender signs to generate their loan
+ * agreement for review — `POST /contract/generate`.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING. kasu-backend rebuilds this string from the
+ * request body and verifies the signature against it, so the wording,
+ * ordering, separators, line breaks and date format are all part of the wire
+ * contract. The separator between the line-2 fields is a MIDDLE DOT U+00B7
+ * (·) with a single space on each side; the four lines are joined with `\n`.
+ *
+ * The backend takes this format only when all four display fields are present
+ * and non-empty, and it cross-checks `amountLabel`'s leading number against
+ * the `depositAmount` it was sent (thousands separators stripped) — a message
+ * that states an amount other than the one being executed is refused.
+ */
+export declare function buildLoanAgreementSignMessage(p: {
+    strategyName: string;
+    region: string;
+    optionName: string;
+    amountLabel: string;
+    timestamp: number;
+}): string;
+/**
+ * The legacy `/contract/generate` and `/contract/resolve` message.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING. kasu-backend rebuilds it as
+ * `` `I request contract content for ${address} at ${timestamp}.` `` from the
+ * `address` and `timestamp` fields of the request body — so the string signed
+ * and the body sent must agree exactly, INCLUDING the address casing. This
+ * builder lowercases, and the request body must carry the same lowercased
+ * address; that is what both apps signing this format do today.
+ *
+ * The backend takes this path whenever the four human-readable display fields
+ * are absent, and documents it as permanent until the legacy app is
+ * decommissioned. `/contract/resolve` has no other format — every consumer
+ * signs this one to retrieve an existing agreement.
+ *
+ * @param timestampMs ms-epoch, and the same value sent as the body's
+ *   `timestamp`.
+ */
+export declare function buildLegacyContractRequestMessage(address: string, timestampMs: number): string;
+/**
+ * The `POST /contract/fullname` message.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING, on the same terms as
+ * `buildLegacyContractRequestMessage`: kasu-backend rebuilds
+ * `` `I request my full name for ${address} at ${timestamp}.` `` from the
+ * request body and verifies the signature against it, so the body must carry
+ * the same lowercased address this builder signs.
+ *
+ * @param timestampMs ms-epoch, and the same value sent as the body's
+ *   `timestamp`.
+ */
+export declare function buildFullNameRequestMessage(address: string, timestampMs: number): string;

package/dist/domain/loan-contract.js

@@ -0,0 +1,160 @@
+import { ethers } from 'ethers';
+/** Narrow the backend's loose `contractType` string to the encoded union. */
+export function asContractType(raw) {
+    return raw === 'exempt' ? 'exempt' : 'retail';
+}
+/**
+ * Parse the server's JSON-string `formattedMessage` into a tree. Returns
+ * `null` on parse failure so a renderer can fall back to the plaintext.
+ */
+export function parseFormattedMessage(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object')
+            return parsed;
+        return null;
+    }
+    catch (_a) {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// The on-chain `depositData` blob
+// ---------------------------------------------------------------------------
+/**
+ * Pack the contract version and type into the `versionType` word.
+ *
+ * ```
+ * high byte = contract version (>= 1)
+ * low byte  = 0 for retail, 1 for exempt
+ * ```
+ */
+export function buildContractVersionType(contractVersion, contractType) {
+    return (contractVersion << 8) + (contractType === 'retail' ? 0 : 1);
+}
+/**
+ * Build the on-chain `depositData` blob that `requestDepositWithKyc` expects.
+ *
+ * The KasuController decodes the bytes as
+ * `(bytes signature, uint256 timestamp, uint256 versionType)` and uses the
+ * embedded acceptance signature to verify — retrospectively, via the
+ * agreements service `/contract/resolve` — that the lender signed the
+ * loan-contract text. The ABI tuple and the packing are consensus-critical:
+ * these bytes go on chain.
+ *
+ * kasu-ui encodes this with viem, kasu-mobile with ethers v5 (viem is not
+ * available on Expo). This is the ethers v5 implementation, and
+ * `loan-contract.test.ts` pins its output byte-for-byte against fixtures
+ * produced by the viem version, so the two apps can never diverge here.
+ *
+ * @param args.signature EIP-191 signature from the lender accepting
+ *   `contractMessage`, as a 0x-prefixed hex string.
+ * @param args.timestamp ms-epoch from the contract response.
+ */
+export function encodeDepositData(args) {
+    const versionType = buildContractVersionType(args.contractVersion, args.contractType);
+    return ethers.utils.defaultAbiCoder.encode(['bytes', 'uint256', 'uint256'], [
+        args.signature,
+        ethers.BigNumber.from(args.timestamp),
+        ethers.BigNumber.from(versionType),
+    ]);
+}
+// ---------------------------------------------------------------------------
+// The signed messages
+// ---------------------------------------------------------------------------
+const MONTH_NAMES = [
+    'January',
+    'February',
+    'March',
+    'April',
+    'May',
+    'June',
+    'July',
+    'August',
+    'September',
+    'October',
+    'November',
+    'December',
+];
+/**
+ * Format a unix timestamp as `{day} {MonthName} {yyyy}, {HH}:{mm}` in UTC.
+ * Day is non-padded; hour and minute are zero-padded to two digits (24h). A
+ * timestamp with >= 13 digits is treated as milliseconds, otherwise as seconds
+ * — the same auto-detection kasu-backend applies.
+ *
+ * Deliberately a manual formatter with English month names: no locale, no
+ * `Intl`, so the output is byte-identical across runtimes and time zones. This
+ * is not a display date. It goes inside a signed message.
+ *
+ * e.g. 1785313320000 → `"29 July 2026, 08:22"`
+ */
+export function formatSignTimestampUtc(timestamp) {
+    const ms = timestamp.toString().length >= 13 ? timestamp : timestamp * 1000;
+    const date = new Date(ms);
+    const day = date.getUTCDate();
+    const month = MONTH_NAMES[date.getUTCMonth()];
+    const year = date.getUTCFullYear();
+    const hours = String(date.getUTCHours()).padStart(2, '0');
+    const minutes = String(date.getUTCMinutes()).padStart(2, '0');
+    return `${day} ${month} ${year}, ${hours}:${minutes}`;
+}
+/**
+ * The 4-line human-readable message a lender signs to generate their loan
+ * agreement for review — `POST /contract/generate`.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING. kasu-backend rebuilds this string from the
+ * request body and verifies the signature against it, so the wording,
+ * ordering, separators, line breaks and date format are all part of the wire
+ * contract. The separator between the line-2 fields is a MIDDLE DOT U+00B7
+ * (·) with a single space on each side; the four lines are joined with `\n`.
+ *
+ * The backend takes this format only when all four display fields are present
+ * and non-empty, and it cross-checks `amountLabel`'s leading number against
+ * the `depositAmount` it was sent (thousands separators stripped) — a message
+ * that states an amount other than the one being executed is refused.
+ */
+export function buildLoanAgreementSignMessage(p) {
+    return [
+        'Generate my Loan Agreement for review:',
+        `${p.strategyName} · ${p.region} · ${p.optionName} · ${p.amountLabel}.`,
+        `Request made ${formatSignTimestampUtc(p.timestamp)} UTC.`,
+        'This request does not commit me to lend.',
+    ].join('\n');
+}
+/**
+ * The legacy `/contract/generate` and `/contract/resolve` message.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING. kasu-backend rebuilds it as
+ * `` `I request contract content for ${address} at ${timestamp}.` `` from the
+ * `address` and `timestamp` fields of the request body — so the string signed
+ * and the body sent must agree exactly, INCLUDING the address casing. This
+ * builder lowercases, and the request body must carry the same lowercased
+ * address; that is what both apps signing this format do today.
+ *
+ * The backend takes this path whenever the four human-readable display fields
+ * are absent, and documents it as permanent until the legacy app is
+ * decommissioned. `/contract/resolve` has no other format — every consumer
+ * signs this one to retrieve an existing agreement.
+ *
+ * @param timestampMs ms-epoch, and the same value sent as the body's
+ *   `timestamp`.
+ */
+export function buildLegacyContractRequestMessage(address, timestampMs) {
+    return `I request contract content for ${address.toLowerCase()} at ${timestampMs}.`;
+}
+/**
+ * The `POST /contract/fullname` message.
+ *
+ * ⚠️ BYTE-EXACT PROTOCOL STRING, on the same terms as
+ * `buildLegacyContractRequestMessage`: kasu-backend rebuilds
+ * `` `I request my full name for ${address} at ${timestamp}.` `` from the
+ * request body and verifies the signature against it, so the body must carry
+ * the same lowercased address this builder signs.
+ *
+ * @param timestampMs ms-epoch, and the same value sent as the body's
+ *   `timestamp`.
+ */
+export function buildFullNameRequestMessage(address, timestampMs) {
+    return `I request my full name for ${address.toLowerCase()} at ${timestampMs}.`;
+}
+//# sourceMappingURL=loan-contract.js.map