@kasufinance/kasu-sdk 2.5.0 → 2.6.0

package/dist/domain/settlement.js

@@ -0,0 +1,117 @@
+/**
+ * Cycles and the clearing window — the protocol's weekly clock, as numbers.
+ *
+ * Lifted verbatim from kasu-ui's `features/portfolio/lib/settlement-window.ts`
+ * and `features/lending/lib/cycle-dates.ts`. The two formatters that live
+ * beside `deriveCycleDates` there (`formatCycleDate`, `formatCycleCloseUtc`)
+ * print words and stay in the applications; everything here is unix seconds in
+ * and unix seconds out.
+ *
+ * The clearing window is the fixed 48 hours immediately preceding an epoch
+ * end. Inside it, pending requests are being processed and cannot be modified,
+ * and the countdown runs to the epoch end. Outside it, the countdown runs to
+ * the next clearing-window start.
+ *
+ * The epoch end comes straight from the chain (`nextEpochStartTimestamp`, i.e.
+ * the SDK's `getNextEpochDate`) — the same value the protocol's own
+ * `getNextClearingPeriodDate` derives from — so the window always lines up
+ * with the real weekly schedule (Tue 06:00 → Thu 06:00 UTC on Base) instead of
+ * a projected subgraph timestamp that can drift off the grid.
+ */
+/**
+ * Clearing-window length — a fixed 48h protocol constant. Exported so every
+ * consumer derives the window from the same number this module runs on.
+ */
+export const CLEARING_WINDOW_SECONDS = 48 * 60 * 60;
+/**
+ * Weekly cadence — the epoch schedule is fixed weekly (Tue → Thu UTC on Base).
+ * Used only to roll a cycle forward when a request lands inside a window that
+ * has already closed.
+ */
+const WEEK_SECONDS = 7 * 24 * 60 * 60;
+/**
+ * Which phase of the weekly cycle `nowSeconds` falls in, and how long is left
+ * of it.
+ *
+ * `'unknown'` when no epoch boundary has been loaded yet, or when the one on
+ * hand is stale (it has already elapsed — the on-chain value refetches to the
+ * next boundary shortly after rollover). A caller must render its "no cycle
+ * loaded" state there, never a zeroed countdown.
+ */
+export function computeSettlementWindow({ nowSeconds, nextEpochStart, clearingWindowSeconds = CLEARING_WINDOW_SECONDS, }) {
+    // No epoch boundary loaded yet, or a stale one that already elapsed.
+    if (nextEpochStart <= 0 || nextEpochStart <= nowSeconds) {
+        return { phase: 'unknown' };
+    }
+    const clearingStart = nextEpochStart - clearingWindowSeconds;
+    if (nowSeconds < clearingStart) {
+        return {
+            phase: 'awaiting',
+            secondsUntilClearing: clearingStart - nowSeconds,
+            nextClearingStart: clearingStart,
+        };
+    }
+    // nowSeconds is in [clearingStart, nextEpochStart) — inside the window.
+    return {
+        phase: 'clearing',
+        secondsUntilEpochEnd: nextEpochStart - nowSeconds,
+        epochEnd: nextEpochStart,
+    };
+}
+/**
+ * The next cycle boundary strictly after `nowSeconds`, in unix seconds — the
+ * cycle close (`nextEpochStart − 48h`) while the window is still open, the
+ * epoch end once we are inside it.
+ *
+ * `undefined` when there is no boundary left to wait for: no epoch boundary
+ * loaded, or a cached one that has already elapsed — the same staleness rule
+ * `computeSettlementWindow` applies before it reports `'unknown'`.
+ *
+ * Split out of the state machine because some consumers need the INSTANT
+ * rather than the phase: one to flush the cycle-dependent caches when the
+ * clock crosses it, one to move a pre-commit screen's snapshot clock at the
+ * same moment.
+ */
+export function nextCycleBoundary(nextEpochStart, nowSeconds, clearingWindowSeconds = CLEARING_WINDOW_SECONDS) {
+    if (!nextEpochStart || nextEpochStart <= 0)
+        return undefined;
+    const clearingStart = nextEpochStart - clearingWindowSeconds;
+    if (nowSeconds < clearingStart)
+        return clearingStart;
+    if (nowSeconds < nextEpochStart)
+        return nextEpochStart;
+    return undefined;
+}
+/**
+ * The cycle-close and outcome dates for a request submitted `now`.
+ *
+ * - The cycle "closes" (stops accepting requests, starts processing) at the
+ *   start of the 48h clearing window, i.e. 48h before the epoch end.
+ * - Processing takes up to 48h, so the outcome is confirmed by the epoch end
+ *   (close + 48h).
+ *
+ * Returns `null` when the epoch boundary is not available or is stale — a
+ * caller then omits the dates entirely (omit, don't stub).
+ *
+ * The common case is a request submitted OUTSIDE the clearing window: the
+ * close is `nextEpochStart − 48h` and the outcome is `nextEpochStart`. When
+ * the request lands INSIDE the current clearing window (that close is already
+ * in the past), it queues for the NEXT weekly cycle, so the close is advanced
+ * by whole weeks until it is in the future.
+ */
+export function deriveCycleDates(nextEpochStart, nowSeconds) {
+    // No boundary loaded, or a stale one that already elapsed — the same
+    // staleness rule as `computeSettlementWindow`.
+    if (!nextEpochStart || nextEpochStart <= nowSeconds)
+        return null;
+    let close = nextEpochStart - CLEARING_WINDOW_SECONDS;
+    let outcome = nextEpochStart;
+    // Inside the current clearing window the close already passed; a request
+    // now is queued for the next weekly cycle.
+    while (close <= nowSeconds) {
+        close += WEEK_SECONDS;
+        outcome += WEEK_SECONDS;
+    }
+    return { close, outcome };
+}
+//# sourceMappingURL=settlement.js.map

package/dist/domain/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../../src/domain/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAEpD;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAwBtC;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACpC,UAAU,EACV,cAAc,EACd,qBAAqB,GAAG,uBAAuB,GAC3B;IACpB,qEAAqE;IACrE,IAAI,cAAc,IAAI,CAAC,IAAI,cAAc,IAAI,UAAU,EAAE,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,aAAa,GAAG,cAAc,GAAG,qBAAqB,CAAC;IAE7D,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QAC7B,OAAO;YACH,KAAK,EAAE,UAAU;YACjB,oBAAoB,EAAE,aAAa,GAAG,UAAU;YAChD,iBAAiB,EAAE,aAAa;SACnC,CAAC;IACN,CAAC;IAED,wEAAwE;IACxE,OAAO;QACH,KAAK,EAAE,UAAU;QACjB,oBAAoB,EAAE,cAAc,GAAG,UAAU;QACjD,QAAQ,EAAE,cAAc;KAC3B,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC7B,cAAkC,EAClC,UAAkB,EAClB,wBAAgC,uBAAuB;IAEvD,IAAI,CAAC,cAAc,IAAI,cAAc,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,MAAM,aAAa,GAAG,cAAc,GAAG,qBAAqB,CAAC;IAC7D,IAAI,UAAU,GAAG,aAAa;QAAE,OAAO,aAAa,CAAC;IACrD,IAAI,UAAU,GAAG,cAAc;QAAE,OAAO,cAAc,CAAC;IACvD,OAAO,SAAS,CAAC;AACrB,CAAC;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC5B,cAAkC,EAClC,UAAkB;IAElB,qEAAqE;IACrE,+CAA+C;IAC/C,IAAI,CAAC,cAAc,IAAI,cAAc,IAAI,UAAU;QAAE,OAAO,IAAI,CAAC;IAEjE,IAAI,KAAK,GAAG,cAAc,GAAG,uBAAuB,CAAC;IACrD,IAAI,OAAO,GAAG,cAAc,CAAC;IAC7B,yEAAyE;IACzE,2CAA2C;IAC3C,OAAO,KAAK,IAAI,UAAU,EAAE,CAAC;QACzB,KAAK,IAAI,YAAY,CAAC;QACtB,OAAO,IAAI,YAAY,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

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

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

package/dist/domain/settlement.test.js

@@ -0,0 +1,152 @@
+import { CLEARING_WINDOW_SECONDS, computeSettlementWindow, deriveCycleDates, nextCycleBoundary, } from './settlement';
+/**
+ * Ported from kasu-ui `src/features/portfolio/lib/settlement-window.test.ts`
+ * and the non-format half of
+ * `src/features/lending/lib/cycle-dates.test.ts`. The `formatCycleDate` /
+ * `formatCycleCloseUtc` cases stay there — they assert printed words.
+ */
+const HOUR = 60 * 60;
+const DAY = 24 * HOUR;
+const CLEARING = 48 * HOUR;
+const WEEK = 7 * DAY;
+describe('computeSettlementWindow', () => {
+    it('returns "unknown" when the epoch boundary is missing', () => {
+        expect(computeSettlementWindow({
+            nowSeconds: 1000000,
+            nextEpochStart: 0,
+        })).toEqual({ phase: 'unknown' });
+    });
+    it('returns "unknown" when the epoch boundary is stale (already elapsed)', () => {
+        expect(computeSettlementWindow({
+            nowSeconds: 1000000,
+            nextEpochStart: 999000,
+        })).toEqual({ phase: 'unknown' });
+    });
+    it('counts down to the clearing window when more than 48h from epoch end', () => {
+        const epochEnd = 1700000000; // Thu 06:00 UTC
+        const now = epochEnd - 3 * DAY; // 24h before the window opens
+        const result = computeSettlementWindow({
+            nowSeconds: now,
+            nextEpochStart: epochEnd,
+        });
+        expect(result.phase).toBe('awaiting');
+        if (result.phase !== 'awaiting')
+            return;
+        expect(result.nextClearingStart).toBe(epochEnd - CLEARING); // Tue 06:00
+        expect(result.secondsUntilClearing).toBe(DAY);
+    });
+    it('reports "clearing" only inside the 48h window before epoch end', () => {
+        const epochEnd = 1700000000;
+        const now = epochEnd - 24 * HOUR; // 24h into the window
+        const result = computeSettlementWindow({
+            nowSeconds: now,
+            nextEpochStart: epochEnd,
+        });
+        expect(result.phase).toBe('clearing');
+        if (result.phase !== 'clearing')
+            return;
+        expect(result.epochEnd).toBe(epochEnd);
+        expect(result.secondsUntilEpochEnd).toBe(24 * HOUR);
+    });
+    it('flips awaiting → clearing exactly at the window boundary (T-48h)', () => {
+        const epochEnd = 1700000000;
+        expect(computeSettlementWindow({
+            nowSeconds: epochEnd - CLEARING - 1,
+            nextEpochStart: epochEnd,
+        }).phase).toBe('awaiting');
+        expect(computeSettlementWindow({
+            nowSeconds: epochEnd - CLEARING,
+            nextEpochStart: epochEnd,
+        }).phase).toBe('clearing');
+    });
+    it('respects a non-default clearing window length', () => {
+        const epochEnd = 1700000000;
+        const now = epochEnd - 36 * HOUR;
+        // 36h out is "clearing" under the default 48h window but "awaiting"
+        // under a 24h one.
+        expect(computeSettlementWindow({
+            nowSeconds: now,
+            nextEpochStart: epochEnd,
+        }).phase).toBe('clearing');
+        expect(computeSettlementWindow({
+            nowSeconds: now,
+            nextEpochStart: epochEnd,
+            clearingWindowSeconds: 24 * HOUR,
+        }).phase).toBe('awaiting');
+    });
+});
+describe('nextCycleBoundary', () => {
+    const epochEnd = 1700000000;
+    const clearingStart = epochEnd - CLEARING;
+    it('returns the cycle close while the window is still ahead', () => {
+        expect(nextCycleBoundary(epochEnd, epochEnd - 3 * DAY)).toBe(clearingStart);
+    });
+    it('returns the epoch end once inside the clearing window', () => {
+        expect(nextCycleBoundary(epochEnd, clearingStart + 1)).toBe(epochEnd);
+    });
+    it('hands over from close to epoch end exactly at the boundary instant', () => {
+        // At T-48h the close has just been reached, so the next thing to wait
+        // for is the epoch end — not the instant we are standing on.
+        expect(nextCycleBoundary(epochEnd, clearingStart - 1)).toBe(clearingStart);
+        expect(nextCycleBoundary(epochEnd, clearingStart)).toBe(epochEnd);
+    });
+    it('returns undefined when there is nothing left to wait for', () => {
+        expect(nextCycleBoundary(epochEnd, epochEnd)).toBeUndefined(); // elapsed
+        expect(nextCycleBoundary(epochEnd, epochEnd + DAY)).toBeUndefined(); // stale
+        expect(nextCycleBoundary(undefined, epochEnd - DAY)).toBeUndefined(); // not loaded
+        expect(nextCycleBoundary(0, epochEnd - DAY)).toBeUndefined(); // sentinel zero
+    });
+    it('agrees with computeSettlementWindow about where the window opens', () => {
+        // One number, two consumers: the phase machine and the timer helper
+        // must never disagree about when the cycle turns.
+        expect(CLEARING_WINDOW_SECONDS).toBe(CLEARING);
+        const justInside = nextCycleBoundary(epochEnd, clearingStart);
+        expect(computeSettlementWindow({
+            nowSeconds: clearingStart,
+            nextEpochStart: epochEnd,
+        }).phase).toBe('clearing');
+        expect(justInside).toBe(epochEnd);
+    });
+    it('respects a non-default clearing window length', () => {
+        const now = epochEnd - 36 * HOUR;
+        // 36h out: inside a 48h window (next stop is the epoch end), still
+        // ahead of a 24h one (next stop is that window opening).
+        expect(nextCycleBoundary(epochEnd, now)).toBe(epochEnd);
+        expect(nextCycleBoundary(epochEnd, now, 24 * HOUR)).toBe(epochEnd - 24 * HOUR);
+    });
+});
+describe('deriveCycleDates', () => {
+    // Fixture: epoch end = Thu 6 Aug 2026, 06:00 UTC.
+    const EPOCH_END = Date.UTC(2026, 7, 6, 6, 0, 0) / 1000; // 1785996000
+    const CLOSE = EPOCH_END - CLEARING; // Tue 4 Aug 06:00 UTC
+    it('returns close = epochEnd − 48h and outcome = epochEnd before the window opens', () => {
+        const now = Date.UTC(2026, 7, 1, 12, 0, 0) / 1000; // Sat 1 Aug
+        expect(deriveCycleDates(EPOCH_END, now)).toEqual({
+            close: CLOSE,
+            outcome: EPOCH_END,
+        });
+    });
+    it('advances to the next weekly cycle when the request lands inside the clearing window', () => {
+        // now is Wed 5 Aug 00:00 — inside [close, epochEnd): this cycle has
+        // already closed, so the request queues for next week.
+        const now = Date.UTC(2026, 7, 5, 0, 0, 0) / 1000;
+        expect(deriveCycleDates(EPOCH_END, now)).toEqual({
+            close: CLOSE + WEEK,
+            outcome: EPOCH_END + WEEK,
+        });
+    });
+    it('returns null when the epoch boundary is missing', () => {
+        expect(deriveCycleDates(undefined, EPOCH_END - WEEK)).toBeNull();
+        expect(deriveCycleDates(0, EPOCH_END - WEEK)).toBeNull();
+    });
+    it('returns null when the epoch boundary is stale (already elapsed)', () => {
+        expect(deriveCycleDates(EPOCH_END, EPOCH_END + 60)).toBeNull();
+    });
+    it('runs on the same window constant as the phase machine', () => {
+        var _a;
+        const now = Date.UTC(2026, 7, 1, 12, 0, 0) / 1000;
+        const dates = deriveCycleDates(EPOCH_END, now);
+        expect(dates === null || dates === void 0 ? void 0 : dates.outcome).toBe(((_a = dates === null || dates === void 0 ? void 0 : dates.close) !== null && _a !== void 0 ? _a : 0) + CLEARING_WINDOW_SECONDS);
+    });
+});
+//# sourceMappingURL=settlement.test.js.map

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

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

package/dist/domain/wallet-errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Wallet and RPC error predicates — pure functions over `unknown`.
+ *
+ * Every consumer has to tell three things apart when a write fails: the lender
+ * changed their mind, the call would revert, and everything else. The first
+ * two must never be reported as a failure the lender should retry or contact
+ * support about, and each wallet spells them differently, so the shapes are
+ * enumerated once here.
+ *
+ * Lifted from kasu-ui's `src/lib/web3/is-user-rejected.ts` and kasu-mobile's
+ * `src/features/lending/lib/errors.ts`.
+ */
+/**
+ * Did the lender reject the request in their wallet?
+ *
+ * Providers surface a rejection in different shapes:
+ *   - MetaMask and most EIP-1193 wallets: `code: 4001`
+ *   - WalletConnect and some Privy paths: `Error('User rejected the request')`
+ *   - ethers v5 wraps it as `ACTION_REJECTED`
+ *   - Coinbase Wallet sometimes: `code: 'ACTION_REJECTED'` as a string
+ *
+ * This is kasu-ui's implementation verbatim. kasu-mobile's copy additionally
+ * reads a nested `error.code` / `error.message`, an ethers `reason`, and the
+ * words "request rejected" / "declined"; a consumer that needs those shapes
+ * should keep its own check on top rather than assume they are covered here.
+ */
+export declare function isUserRejected(err: unknown): boolean;
+/**
+ * Did the wallet or RPC signal that the on-chain call would revert?
+ *
+ * ethers v5 raises `UNPREDICTABLE_GAS_LIMIT` when gas estimation reverts —
+ * most often an underlying `transferFrom` failing on an insufficient balance
+ * or allowance. Distinct from a rejection: nothing was refused by the lender,
+ * the transaction simply cannot succeed as composed, so the caller should
+ * re-check its preconditions rather than invite a retry.
+ */
+export declare function isUnpredictableGas(err: unknown): boolean;

package/dist/domain/wallet-errors.js

@@ -0,0 +1,56 @@
+/**
+ * Wallet and RPC error predicates — pure functions over `unknown`.
+ *
+ * Every consumer has to tell three things apart when a write fails: the lender
+ * changed their mind, the call would revert, and everything else. The first
+ * two must never be reported as a failure the lender should retry or contact
+ * support about, and each wallet spells them differently, so the shapes are
+ * enumerated once here.
+ *
+ * Lifted from kasu-ui's `src/lib/web3/is-user-rejected.ts` and kasu-mobile's
+ * `src/features/lending/lib/errors.ts`.
+ */
+/**
+ * Did the lender reject the request in their wallet?
+ *
+ * Providers surface a rejection in different shapes:
+ *   - MetaMask and most EIP-1193 wallets: `code: 4001`
+ *   - WalletConnect and some Privy paths: `Error('User rejected the request')`
+ *   - ethers v5 wraps it as `ACTION_REJECTED`
+ *   - Coinbase Wallet sometimes: `code: 'ACTION_REJECTED'` as a string
+ *
+ * This is kasu-ui's implementation verbatim. kasu-mobile's copy additionally
+ * reads a nested `error.code` / `error.message`, an ethers `reason`, and the
+ * words "request rejected" / "declined"; a consumer that needs those shapes
+ * should keep its own check on top rather than assume they are covered here.
+ */
+export function isUserRejected(err) {
+    if (!err)
+        return false;
+    if (typeof err === 'object') {
+        const code = err.code;
+        if (code === 4001 || code === 'ACTION_REJECTED')
+            return true;
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    const lower = msg.toLowerCase();
+    return (lower.includes('user rejected') ||
+        lower.includes('user denied') ||
+        lower.includes('rejected the request') ||
+        lower.includes('action_rejected'));
+}
+/**
+ * Did the wallet or RPC signal that the on-chain call would revert?
+ *
+ * ethers v5 raises `UNPREDICTABLE_GAS_LIMIT` when gas estimation reverts —
+ * most often an underlying `transferFrom` failing on an insufficient balance
+ * or allowance. Distinct from a rejection: nothing was refused by the lender,
+ * the transaction simply cannot succeed as composed, so the caller should
+ * re-check its preconditions rather than invite a retry.
+ */
+export function isUnpredictableGas(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    return err.code === 'UNPREDICTABLE_GAS_LIMIT';
+}
+//# sourceMappingURL=wallet-errors.js.map

package/dist/domain/wallet-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../src/domain/wallet-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAC;QAC9C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,iBAAiB;YAAE,OAAO,IAAI,CAAC;IACjE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,OAAO,CACH,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;QAC/B,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC7B,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACtC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CACpC,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC3C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,OAAQ,GAA0B,CAAC,IAAI,KAAK,yBAAyB,CAAC;AAC1E,CAAC"}

package/dist/domain/wallet-errors.test.d.ts

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

package/dist/domain/wallet-errors.test.js

@@ -0,0 +1,71 @@
+import { isUnpredictableGas, isUserRejected } from './wallet-errors';
+/**
+ * `isUserRejected` cases ported from kasu-ui
+ * `src/lib/web3/is-user-rejected.test.ts`. `isUnpredictableGas` had no test in
+ * kasu-mobile; one is written here.
+ */
+describe('isUserRejected', () => {
+    it('detects EIP-1193 numeric code 4001', () => {
+        expect(isUserRejected({ code: 4001, message: 'whatever' })).toBe(true);
+    });
+    it('detects ACTION_REJECTED string code (ethers v5)', () => {
+        expect(isUserRejected({ code: 'ACTION_REJECTED', message: 'rejected' })).toBe(true);
+    });
+    it('detects "User rejected" message string', () => {
+        expect(isUserRejected(new Error('User rejected the request'))).toBe(true);
+    });
+    it('detects "User denied" message string', () => {
+        expect(isUserRejected(new Error('User denied transaction signature'))).toBe(true);
+    });
+    it('detects the ethers ACTION_REJECTED marker in a message', () => {
+        expect(isUserRejected(new Error('transaction failed: ACTION_REJECTED'))).toBe(true);
+    });
+    it('is case-insensitive', () => {
+        expect(isUserRejected(new Error('user REJECTED the request'))).toBe(true);
+    });
+    it('returns false for unrelated errors', () => {
+        expect(isUserRejected(new Error('Network error'))).toBe(false);
+        expect(isUserRejected(new Error('Insufficient funds'))).toBe(false);
+    });
+    it('returns false for null / undefined', () => {
+        expect(isUserRejected(null)).toBe(false);
+        expect(isUserRejected(undefined)).toBe(false);
+    });
+    it('handles non-Error throwables', () => {
+        expect(isUserRejected('user rejected')).toBe(true);
+        expect(isUserRejected('something else')).toBe(false);
+    });
+    it('is not fooled by a numeric code that only looks like 4001', () => {
+        expect(isUserRejected({ code: '4001' })).toBe(false);
+        expect(isUserRejected({ code: 4002 })).toBe(false);
+    });
+});
+describe('isUnpredictableGas', () => {
+    it('detects the ethers v5 gas-estimation revert code', () => {
+        expect(isUnpredictableGas({ code: 'UNPREDICTABLE_GAS_LIMIT' })).toBe(true);
+    });
+    it('does not fire on a user rejection', () => {
+        expect(isUnpredictableGas({ code: 'ACTION_REJECTED' })).toBe(false);
+        expect(isUnpredictableGas({ code: 4001 })).toBe(false);
+    });
+    it('does not fire on the code appearing only in a message', () => {
+        // The code is the signal; a message mentioning it is not one, or a
+        // logged error string would be mistaken for a revert.
+        expect(isUnpredictableGas(new Error('UNPREDICTABLE_GAS_LIMIT'))).toBe(false);
+        expect(isUnpredictableGas('UNPREDICTABLE_GAS_LIMIT')).toBe(false);
+    });
+    it('returns false for null / undefined and for unrelated errors', () => {
+        expect(isUnpredictableGas(null)).toBe(false);
+        expect(isUnpredictableGas(undefined)).toBe(false);
+        expect(isUnpredictableGas(new Error('Network error'))).toBe(false);
+    });
+    it('reads the code off an ethers error object', () => {
+        const err = Object.assign(new Error('cannot estimate gas'), {
+            code: 'UNPREDICTABLE_GAS_LIMIT',
+            reason: 'execution reverted: ERC20: insufficient allowance',
+        });
+        expect(isUnpredictableGas(err)).toBe(true);
+        expect(isUserRejected(err)).toBe(false);
+    });
+});
+//# sourceMappingURL=wallet-errors.test.js.map

package/dist/domain/wallet-errors.test.js.map

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

package/dist/facade/chain-configs.js

@@ -139,7 +139,13 @@ export const CHAIN_CONFIGS = {
             ClearingCoordinator: '',
             ExternalTVL: '',
         },
-        subgraphUrl: 'https://api.goldsky.com/api/public/project_cmgzlpxm300765np2a19421om/subgraphs/kasu-plume/prod',
+        // The frozen Plume history is indexed on the LEGACY Goldsky project,
+        // not the one the live chains use: the same path under the current
+        // project 404s. Verified 2026-09-05 — this URL answers
+        // `{ lendingPools { id name } }` with the three Plume pools; the
+        // current-project spelling returns HTTP 404. Note the `/gn` suffix,
+        // which the current project's URLs do not carry.
+        subgraphUrl: 'https://api.goldsky.com/api/public/project_cm9t3064xeuyn01tgctdo3c17/subgraphs/kasu-plume/prod/gn',
         directusUrl: 'https://kasu-finance.directus.app/',
         unusedPoolIds: [],
         poolMetadataMapping: undefined,

package/dist/facade/chain-configs.js.map

@@ -1 +1 @@
-{"version":3,"file":"chain-configs.js","sourceRoot":"","sources":["../../src/facade/chain-configs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chain-configs.js","sourceRoot":"","sources":["../../src/facade/chain-configs.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,YAAY,GAAa;IAC3B,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,+BAA+B;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoE;IAC1F,IAAI,EAAE;QACF,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,cAAc;QACpB,gBAAgB,EAAE,KAAK;QACvB,SAAS,EAAE;YACP,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,kBAAkB,EAAE,4CAA4C;YAChE,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,QAAQ,EAAE,4CAA4C;YACtD,kBAAkB,EAAE,4CAA4C;YAChE,mBAAmB,EAAE,4CAA4C;YACjE,QAAQ,EAAE,4CAA4C;YACtD,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EACP,qGAAqG;QACzG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;QAC9B,WAAW,EAAE;YACT,OAAO,EAAE,4CAA4C;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,KAAK;SACtB;QACD,OAAO,EAAE;YACL,iCAAiC;YACjC,0BAA0B;SAC7B;KACJ;IAED,GAAG,EAAE;QACD,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACP,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,kBAAkB,EAAE,4CAA4C;YAChE,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,QAAQ,EAAE,4CAA4C;YACtD,kBAAkB,EAAE,4CAA4C;YAChE,mBAAmB,EAAE,4CAA4C;YACjE,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EACP,mGAAmG;QACvG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE;YACjB,4CAA4C,EACxC,4CAA4C;YAChD,4CAA4C,EACxC,4CAA4C;YAChD,4CAA4C,EACxC,4CAA4C;SACnD;QACD,WAAW,EAAE;YACT,OAAO,EAAE,4CAA4C;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,2BAA2B;YACjC,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,KAAK;SACtB;QACD,OAAO,EAAE,YAAY;KACxB;IAED,UAAU,EAAE;QACR,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,oBAAoB;QAC1B,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACP,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,kBAAkB,EAAE,4CAA4C;YAChE,WAAW,EAAE,4CAA4C;YACzD,aAAa,EAAE,4CAA4C;YAC3D,eAAe,EAAE,4CAA4C;YAC7D,QAAQ,EAAE,4CAA4C;YACtD,kBAAkB,EAAE,4CAA4C;YAChE,mBAAmB,EAAE,4CAA4C;YACjE,kCAAkC;YAClC,WAAW,EAAE,4CAA4C;SAC5D;QACD,WAAW,EACP,wGAAwG;QAC5G,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;QAC9B,WAAW,EAAE;YACT,OAAO,EAAE,4CAA4C;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,KAAK;SACtB;QACD,OAAO,EAAE,YAAY;KACxB;IAED,KAAK,EAAE;QACH,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,eAAe;QACrB,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE;YACP,yDAAyD;YACzD,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,EAAE;YACjB,kBAAkB,EAAE,EAAE;YACtB,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,EAAE;YACZ,kBAAkB,EAAE,EAAE;YACtB,mBAAmB,EAAE,EAAE;YACvB,WAAW,EAAE,EAAE;SAClB;QACD,qEAAqE;QACrE,mEAAmE;QACnE,uDAAuD;QACvD,iEAAiE;QACjE,oEAAoE;QACpE,iDAAiD;QACjD,WAAW,EACP,mGAAmG;QACvG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;QAC9B,WAAW,EAAE;YACT,OAAO,EAAE,4CAA4C;YACrD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,KAAK;SACtB;QACD,mEAAmE;QACnE,+DAA+D;QAC/D,0DAA0D;QAC1D,iDAAiD;QACjD,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,IAAI;KAChB;CACJ,CAAC"}

package/dist/facade/facade.test.js

@@ -1,8 +1,14 @@
-/**
- * Offline facade specs — a mock provider and pure helpers, no network. Moved
- * here from `src/tests/` so it runs beside the code it covers, and so the
- * opt-in `LIVE_TESTS` gate on `src/tests/` does not take it out of CI.
- */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { NO_DIRECTUS_URL_MESSAGE } from '../services/DataService/directus-client';
+import { UserRequestStatus } from '../services/UserLending/subgraph-types';
 import { CHAIN_CONFIGS } from './chain-configs';
 import { DepositsFacade } from './deposits';
 import { Kasu } from './kasu';
@@ -45,6 +51,15 @@ describe('CHAIN_CONFIGS', () => {
             expect(config.subgraphUrl).toContain('goldsky.com');
         }
     });
+    it('plume points at the LEGACY goldsky project its frozen history is on', () => {
+        // Plume was indexed before the live chains moved to the current
+        // project; the same path under that project returns HTTP 404, so the
+        // retired deployment's history is only readable at this spelling —
+        // note the `/gn` suffix the current project's URLs do not carry.
+        const projectOf = (url) => { var _a; return (_a = url.split('/')[5]) !== null && _a !== void 0 ? _a : ''; };
+        expect(projectOf(CHAIN_CONFIGS.plume.subgraphUrl)).not.toBe(projectOf(CHAIN_CONFIGS.base.subgraphUrl));
+        expect(CHAIN_CONFIGS.plume.subgraphUrl.endsWith('/gn')).toBe(true);
+    });
     it('xdc should have poolMetadataMapping', () => {
         const mapping = CHAIN_CONFIGS.xdc.poolMetadataMapping;
         expect(mapping).toBeDefined();
@@ -108,6 +123,29 @@ describe('Kasu.create()', () => {
         });
         expect(kasu).toBeInstanceOf(Kasu);
     });
+    it('constructs without a directusUrl — on-chain data does not need one', () => {
+        // `createDirectus('')` throws `Invalid URL`, so an SDK configured
+        // without the (documented-optional) CMS URL used to be
+        // unconstructable rather than merely CMS-less.
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: mockProvider,
+            configOverrides: { directusUrl: '' },
+        });
+        expect(kasu).toBeInstanceOf(Kasu);
+        expect(kasu.services.DataService).toBeDefined();
+        expect(kasu.services.UserLending).toBeDefined();
+    });
+    it('refuses a CMS-only call clearly when no directusUrl is configured', () => __awaiter(void 0, void 0, void 0, function* () {
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: mockProvider,
+            configOverrides: { directusUrl: '' },
+        });
+        // A sentence naming what to configure, not a null dereference thrown
+        // from inside the vendor SDK.
+        yield expect(kasu.services.DataService.getPlatformOverview()).rejects.toThrow(NO_DIRECTUS_URL_MESSAGE);
+    }));
     it('should expose the underlying KasuSdk via .services', () => {
         const kasu = Kasu.create({
             chain: 'base',
@@ -167,6 +205,42 @@ describe('StrategiesFacade.calculateDepositLimits()', () => {
     });
 });
 // ---------------------------------------------------------------------------
+// PortfolioFacade.getRequestStates()
+// ---------------------------------------------------------------------------
+describe('PortfolioFacade.getRequestStates()', () => {
+    it('maps the transaction history through deriveRequestState', () => __awaiter(void 0, void 0, void 0, function* () {
+        const requests = [
+            makeUserRequest({ id: 'req-1' }),
+            makeUserRequest({
+                id: 'req-2',
+                requestType: 'Withdrawal',
+                status: UserRequestStatus.PROCESSED,
+                canCancel: false,
+                acceptedAmount: '100',
+            }),
+        ];
+        const userLending = {
+            getCurrentEpoch: () => Promise.resolve('42'),
+            getUserRequests: () => Promise.resolve(requests),
+        };
+        const facade = new PortfolioFacade({}, userLending, {});
+        const states = yield facade.getRequestStates('0xuser');
+        expect(states.map((s) => s.id)).toEqual(['req-1', 'req-2']);
+        expect(states[0].statusCode).toBe('pending');
+        expect(states[0].amount).toBe(100);
+        expect(states[1].statusCode).toBe('complete');
+        expect(states[1].amount).toBe(-100);
+    }));
+    it('returns an empty list for a wallet with no history', () => __awaiter(void 0, void 0, void 0, function* () {
+        const userLending = {
+            getCurrentEpoch: () => Promise.resolve('42'),
+            getUserRequests: () => Promise.resolve([]),
+        };
+        const facade = new PortfolioFacade({}, userLending, {});
+        yield expect(facade.getRequestStates('0xuser')).resolves.toEqual([]);
+    }));
+});
+// ---------------------------------------------------------------------------
 // Type exports — verify key facade types are importable
 // ---------------------------------------------------------------------------
 describe('Type re-exports', () => {
@@ -198,4 +272,7 @@ function makeTranche(raw) {
         _raw: Object.assign(Object.assign({}, raw), { id: '0xtest', name: 'Test Tranche', apy: '0.08', minApy: '0.06', maxApy: '0.10', fixedTermConfig: [] }),
     };
 }
+function makeUserRequest(overrides = {}) {
+    return Object.assign({ id: 'req-1', userId: '0xuser', lendingPool: { id: '0xpool', name: 'Pool', tranches: [{ orderId: '0' }] }, requestType: 'Deposit', trancheId: '0xtranche', trancheName: 'Senior', requestedAmount: '100', acceptedAmount: '0', rejectedAmount: '0', timestamp: 1700000000, status: UserRequestStatus.REQUESTED, canCancel: true, events: [], nftId: '', apy: '0', fixedTermConfig: undefined }, overrides);
+}
 //# sourceMappingURL=facade.test.js.map