@kasufinance/kasu-sdk 2.4.1 → 2.5.0

package/dist/domain/tranches.test.js

@@ -0,0 +1,206 @@
+import * as fc from 'fast-check';
+import { netEffectiveApy } from './rates';
+import { compareTrancheSeniority, derivePoolStatus, MIN_TRANCHE_CAPACITY, netTrancheApyBounds, pickDefaultTrancheId, poolAllTranchesFull, trancheApyBounds, trancheHasCapacity, trancheRiskRank, } from './tranches';
+/**
+ * Ported from kasu-ui `pick-default-tranche.test.ts` and the NUMERIC half of
+ * `format-tranche-apy.range.test.ts`. The formatting cases — whole-percent
+ * rendering, the en-dash shape, the locale table and the "collapse when both
+ * bounds print the same" rule — stay in kasu-ui: they are decided on rendered
+ * digits, which this layer never produces.
+ */
+// `id === name` keeps assertions readable; `poolCapacity` drives
+// `trancheHasCapacity` (≥ 1 stable unit → selectable).
+function tranche(name, poolCapacity, apy = '0.12') {
+    return { id: name, name, apy, poolCapacity };
+}
+function pool(tranches, enabled = true) {
+    return { id: 'p', poolName: 'p', enabled, tranches };
+}
+function rated(minApy, maxApy) {
+    return { minApy, maxApy };
+}
+/** The live performance fee on all deployments (subgraph units: 10 = 10%). */
+const FEE = 10;
+describe('trancheHasCapacity', () => {
+    it('accepts a tranche with at least one whole stable unit left', () => {
+        expect(trancheHasCapacity({ poolCapacity: '5000' })).toBe(true);
+        expect(trancheHasCapacity({ poolCapacity: String(MIN_TRANCHE_CAPACITY) })).toBe(true);
+    });
+    it('rejects sub-unit dust, zero and unparseable capacity', () => {
+        expect(trancheHasCapacity({ poolCapacity: '0.99' })).toBe(false);
+        expect(trancheHasCapacity({ poolCapacity: '0' })).toBe(false);
+        expect(trancheHasCapacity({ poolCapacity: '1.4551915228366852e-11' })).toBe(false);
+        expect(trancheHasCapacity({ poolCapacity: '' })).toBe(false);
+        expect(trancheHasCapacity({ poolCapacity: 'not-a-number' })).toBe(false);
+    });
+    it('reads the facade tranche shape (availableCapacity) identically', () => {
+        // `StrategyTranche` renames the same number; one gate, both shapes.
+        expect(trancheHasCapacity({ availableCapacity: '5000' })).toBe(true);
+        expect(trancheHasCapacity({ availableCapacity: '0' })).toBe(false);
+    });
+});
+describe('trancheRiskRank / compareTrancheSeniority', () => {
+    it('ranks the waterfall safest-first by the RAW name', () => {
+        expect(trancheRiskRank(tranche('Senior', '1'))).toBe(0);
+        expect(trancheRiskRank(tranche('Mezzanine', '1'))).toBe(1);
+        expect(trancheRiskRank(tranche('Junior', '1'))).toBe(2);
+    });
+    it('is case- and whitespace-insensitive, and sorts unknown names last', () => {
+        expect(trancheRiskRank(tranche('  SENIOR ', '1'))).toBe(0);
+        expect(trancheRiskRank(tranche('Upper Mezzanine', '1'))).toBe(Number.POSITIVE_INFINITY);
+    });
+    it('sorts Senior → Mezzanine → Junior, keeping ties in input order', () => {
+        const tranches = [
+            tranche('Junior', '5000'),
+            tranche('Tranche B', '5000'),
+            tranche('Senior', '5000'),
+            tranche('Tranche A', '5000'),
+            tranche('Mezzanine', '5000'),
+        ];
+        expect([...tranches].sort(compareTrancheSeniority).map((t) => t.name)).toEqual([
+            'Senior',
+            'Mezzanine',
+            'Junior',
+            'Tranche B',
+            'Tranche A',
+        ]);
+    });
+});
+describe('pickDefaultTrancheId', () => {
+    it('defaults to the lowest-risk tranche (Senior) when all have capacity', () => {
+        // Subgraph order is Junior → Mezzanine → Senior; the default must NOT
+        // be the highest-risk Junior that sits first (audit 3.2).
+        const id = pickDefaultTrancheId(pool([
+            tranche('Junior', '5000'),
+            tranche('Mezzanine', '5000'),
+            tranche('Senior', '5000'),
+        ]));
+        expect(id).toBe('Senior');
+    });
+    it('picks the lowest-risk tranche that is still AVAILABLE (skips a full Senior)', () => {
+        const id = pickDefaultTrancheId(pool([
+            tranche('Junior', '5000'),
+            tranche('Mezzanine', '5000'),
+            tranche('Senior', '0'),
+        ]));
+        expect(id).toBe('Mezzanine');
+    });
+    it('does not rank by APY — a Senior priced above Mezzanine is still preferred', () => {
+        // Real pools can price Senior above Mezzanine; risk is ranked by name,
+        // not rate.
+        const id = pickDefaultTrancheId(pool([
+            tranche('Mezzanine', '5000', '0.15'),
+            tranche('Senior', '5000', '0.18'),
+        ]));
+        expect(id).toBe('Senior');
+    });
+    it('falls back to the lowest-risk tranche when every tranche is full', () => {
+        const id = pickDefaultTrancheId(pool([tranche('Junior', '0'), tranche('Senior', '0')]));
+        expect(id).toBe('Senior');
+    });
+    it('falls back to the first available tranche when names are unrecognised', () => {
+        const id = pickDefaultTrancheId(pool([tranche('Tranche B', '5000'), tranche('Tranche A', '5000')]));
+        expect(id).toBe('Tranche B');
+    });
+    it('returns an empty string for a pool with no tranches', () => {
+        expect(pickDefaultTrancheId(pool([]))).toBe('');
+    });
+});
+describe('poolAllTranchesFull', () => {
+    it('is true when every tranche lacks remaining capacity', () => {
+        expect(poolAllTranchesFull(pool([tranche('Junior', '0'), tranche('Senior', '0')]))).toBe(true);
+    });
+    it('is false when at least one tranche still has capacity', () => {
+        expect(poolAllTranchesFull(pool([tranche('Junior', '0'), tranche('Senior', '5000')]))).toBe(false);
+    });
+    it('is false for a pool with no tranches (nothing to be full)', () => {
+        expect(poolAllTranchesFull(pool([]))).toBe(false);
+    });
+});
+describe('derivePoolStatus', () => {
+    it('is "Coming soon" for a pool that is not yet enabled, full or not', () => {
+        expect(derivePoolStatus(pool([tranche('Senior', '5000')], false))).toBe('Coming soon');
+        expect(derivePoolStatus(pool([tranche('Senior', '0')], false))).toBe('Coming soon');
+    });
+    it('is "Full" for an enabled pool with no capacity anywhere', () => {
+        expect(derivePoolStatus(pool([tranche('Senior', '0')]))).toBe('Full');
+    });
+    it('is "Live" for an enabled pool with capacity, or with no tranches yet', () => {
+        expect(derivePoolStatus(pool([tranche('Senior', '5000')]))).toBe('Live');
+        expect(derivePoolStatus(pool([]))).toBe('Live');
+    });
+});
+describe('trancheApyBounds', () => {
+    it('spans the lowest minApy and the highest maxApy across tranches', () => {
+        expect(trancheApyBounds([rated('0.12', '0.12'), rated('0.185', '0.185')])).toEqual({ min: 0.12, max: 0.185 });
+    });
+    it('carries a single-option strategy as an equal pair', () => {
+        expect(trancheApyBounds([rated('0.1', '0.1')])).toEqual({
+            min: 0.1,
+            max: 0.1,
+        });
+    });
+    it('skips zero and non-finite rates rather than dragging the range down', () => {
+        // A tranche with no fixed-term config must not turn a 10.5% range into
+        // 0–10.5%.
+        expect(trancheApyBounds([rated('0', '0'), rated('0.105', '0.105')])).toEqual({ min: 0.105, max: 0.105 });
+        expect(trancheApyBounds([rated('not-a-number', 'x'), rated('0.12', '0.14')])).toEqual({ min: 0.12, max: 0.14 });
+    });
+    it('is null when nothing usable remains', () => {
+        expect(trancheApyBounds([])).toBeNull();
+        expect(trancheApyBounds([rated('0', '0')])).toBeNull();
+        expect(trancheApyBounds([rated('-0.1', '-0.1')])).toBeNull();
+    });
+    it('is null when only ONE side is usable — never half a range', () => {
+        expect(trancheApyBounds([rated('0.12', '0')])).toBeNull();
+        expect(trancheApyBounds([rated('0', '0.12')])).toBeNull();
+    });
+});
+describe('netTrancheApyBounds', () => {
+    it('reproduces the spec §2.5 card range: 14–22% gross is 13–20% net', () => {
+        const bounds = netTrancheApyBounds([rated('0.14', '0.22')], FEE);
+        expect(bounds).not.toBeNull();
+        expect(bounds === null || bounds === void 0 ? void 0 : bounds.min).toBeCloseTo(0.1252, 4);
+        expect(bounds === null || bounds === void 0 ? void 0 : bounds.max).toBeCloseTo(0.196, 4);
+    });
+    it('puts each bound through netEffectiveApy and nothing else', () => {
+        const bounds = netTrancheApyBounds([rated('0.12', '0.185')], FEE);
+        expect(bounds).toEqual({
+            min: netEffectiveApy(0.12, FEE),
+            max: netEffectiveApy(0.185, FEE),
+        });
+    });
+    it('returns the gross bounds unchanged at a zero fee', () => {
+        expect(netTrancheApyBounds([rated('0.14', '0.22')], 0)).toEqual({
+            min: 0.14,
+            max: 0.22,
+        });
+    });
+    it('FAILS CLOSED on an out-of-domain fee — never the gross range', () => {
+        // The raw subgraph integer (1000 = 10%) and a negative fee both land
+        // here. A caller that does not KNOW the fee must not call at all;
+        // substituting 0 would overstate the rate with nothing saying so.
+        expect(netTrancheApyBounds([rated('0.14', '0.22')], 1000)).toBeNull();
+        expect(netTrancheApyBounds([rated('0.14', '0.22')], -1)).toBeNull();
+        expect(netTrancheApyBounds([rated('0.14', '0.22')], NaN)).toBeNull();
+    });
+    it('is null when a 100% fee leaves the lender nothing', () => {
+        expect(netTrancheApyBounds([rated('0.14', '0.22')], 100)).toBeNull();
+    });
+    it('is null whenever the gross range is', () => {
+        expect(netTrancheApyBounds([], FEE)).toBeNull();
+        expect(netTrancheApyBounds([rated('0', '0')], FEE)).toBeNull();
+    });
+    it('never inverts the range it was given', () => {
+        fc.assert(fc.property(fc.double({ min: 0.0001, max: 0.99, noNaN: true }), fc.double({ min: 0.0001, max: 0.99, noNaN: true }), fc.double({ min: 0, max: 99, noNaN: true }), (a, b, feePercent) => {
+            const bounds = netTrancheApyBounds([
+                rated(String(Math.min(a, b)), String(Math.max(a, b))),
+            ], feePercent);
+            if (!bounds)
+                return;
+            expect(bounds.min).toBeLessThanOrEqual(bounds.max);
+            expect(bounds.min).toBeGreaterThan(0);
+        }), { numRuns: 2000 });
+    });
+});
+//# sourceMappingURL=tranches.test.js.map

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

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

package/dist/facade/chain-configs.js

@@ -1,3 +1,17 @@
+/**
+ * Browser-viable XDC RPCs only. `rpc.xdc.org` / `erpc.xdc.org` answer OPTIONS
+ * without `access-control-allow-origin`, so a browser call hangs on preflight
+ * — they must never appear here. The four below ship CORS `*` and are DISTINCT
+ * operators, so one vendor incident cannot exhaust the list. Order is a
+ * STARTING preference only; consumers are expected to fold the list into their
+ * own failover. Shared by both XDC deployments (same chain, same endpoints).
+ */
+const XDC_RPC_URLS = [
+    'https://rpc.ankr.com/xdc',
+    'https://rpc.xdcrpc.com',
+    'https://rpc.xinfin.network',
+    'https://rpc.primenumbers.xyz/',
+];
 /**
  * Built-in chain configurations for Kasu-supported networks.
  *
@@ -30,6 +44,17 @@ export const CHAIN_CONFIGS = {
         directusUrl: 'https://kasu-finance.directus.app/',
         unusedPoolIds: [],
         poolMetadataMapping: undefined,
+        stableAsset: {
+            address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+            symbol: 'USDC',
+            name: 'USD Coin',
+            decimals: 6,
+            currencyCode: 'USD',
+        },
+        rpcUrls: [
+            'https://base-rpc.publicnode.com',
+            'https://mainnet.base.org',
+        ],
     },
     xdc: {
         chainId: 50,
@@ -57,6 +82,14 @@ export const CHAIN_CONFIGS = {
             '0x3b7cb493aa22f731db2ab424d918e7375e00f6a9': '0x03f93c8caa9a82e000d35673ba34a4c0e6e117a2',
             '0xeda50c91a8c4ca8a83652b8542c0b3bd00a71fad': '0xc347a9e4aec8c8d11a149d2907deb2bf23b81c6f',
         },
+        stableAsset: {
+            address: '0x9fe4e6321eeb7c4bc537570f015e4734b15002b8',
+            symbol: 'AUDD',
+            name: 'Novatti Australian Dollar',
+            decimals: 6,
+            currencyCode: 'AUD',
+        },
+        rpcUrls: XDC_RPC_URLS,
     },
     'xdc-usdc': {
         chainId: 50,
@@ -80,6 +113,14 @@ export const CHAIN_CONFIGS = {
         directusUrl: 'https://kasu-finance.directus.app/',
         unusedPoolIds: [],
         poolMetadataMapping: undefined,
+        stableAsset: {
+            address: '0xfa2958cb79b0491cc627c1557f441ef849ca8eb1',
+            symbol: 'USDC',
+            name: 'USD Coin',
+            decimals: 6,
+            currencyCode: 'USD',
+        },
+        rpcUrls: XDC_RPC_URLS,
     },
     plume: {
         chainId: 98866,
@@ -102,6 +143,19 @@ export const CHAIN_CONFIGS = {
         directusUrl: 'https://kasu-finance.directus.app/',
         unusedPoolIds: [],
         poolMetadataMapping: undefined,
+        stableAsset: {
+            address: '0xdddD73F5Df1F0DC31373357beAC77545dC5A6f3F',
+            symbol: 'pUSD',
+            name: 'Plume USD',
+            decimals: 6,
+            currencyCode: 'USD',
+        },
+        // Retired — drained and wound down. No default RPC, so a read-only
+        // `Kasu.create({ chain: 'plume' })` throws rather than quietly
+        // pointing at an endpoint nobody maintains. Pass your own
+        // `signerOrProvider` to read the frozen history.
+        rpcUrls: [],
+        retired: true,
     },
 };
 //# sourceMappingURL=chain-configs.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"chain-configs.js","sourceRoot":"","sources":["../../src/facade/chain-configs.ts"],"names":[],"mappings":"AAEA;;;;;;;;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;KACjC;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;KACJ;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;KACjC;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,WAAW,EACP,gGAAgG;QACpG,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE,EAAE;QACjB,mBAAmB,EAAE,SAAS;KACjC;CACJ,CAAC"}
+{"version":3,"file":"chain-configs.js","sourceRoot":"","sources":["../../src/facade/chain-configs.ts"],"names":[],"mappings":"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"}

package/dist/facade/config.test.d.ts

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

package/dist/facade/config.test.js

@@ -0,0 +1,216 @@
+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 { providers, Wallet } from 'ethers';
+import { SdkConfig } from '../sdk-config';
+import { CHAIN_CONFIGS } from './chain-configs';
+import { Kasu } from './kasu';
+// Pure config assertions — no network, unlike `facade.test.ts`.
+const BASE_CONTRACTS = CHAIN_CONFIGS.base.contracts;
+/** A signer with a provider attached, offline — nothing here sends anything. */
+function signer() {
+    return Wallet.createRandom().connect(new providers.StaticJsonRpcProvider(CHAIN_CONFIGS.base.rpcUrls[0], CHAIN_CONFIGS.base.chainId));
+}
+describe('SdkConfig — UNUSED_LENDING_POOL_IDS normalisation', () => {
+    it("turns an empty exclusion list into the [''] sentinel", () => {
+        // `id_not_in: []` matches NOTHING in the subgraph: on Base it returns
+        // 0 pools where `['']` returns all 9 (verified live 2026-09-04).
+        const config = new SdkConfig({
+            subgraphUrl: 'https://example.invalid/subgraph',
+            contracts: BASE_CONTRACTS,
+            UNUSED_LENDING_POOL_IDS: [],
+        });
+        expect(config.UNUSED_LENDING_POOL_IDS).toEqual(['']);
+    });
+    it('leaves a caller-supplied exclusion list untouched', () => {
+        const config = new SdkConfig({
+            subgraphUrl: 'https://example.invalid/subgraph',
+            contracts: BASE_CONTRACTS,
+            UNUSED_LENDING_POOL_IDS: ['0xdead'],
+        });
+        expect(config.UNUSED_LENDING_POOL_IDS).toEqual(['0xdead']);
+    });
+    it('leaves a sentinel a consumer already passes untouched', () => {
+        // kasu-ui passes [''], kasu-mobile passes the zero address.
+        const zeroAddress = '0x0000000000000000000000000000000000000000';
+        for (const sentinel of [[''], [zeroAddress]]) {
+            const config = new SdkConfig({
+                subgraphUrl: 'https://example.invalid/subgraph',
+                contracts: BASE_CONTRACTS,
+                UNUSED_LENDING_POOL_IDS: sentinel,
+            });
+            expect(config.UNUSED_LENDING_POOL_IDS).toEqual(sentinel);
+        }
+    });
+});
+describe('CHAIN_CONFIGS — stable asset', () => {
+    it('gives every chain exactly one stable asset', () => {
+        for (const [chain, config] of Object.entries(CHAIN_CONFIGS)) {
+            expect(config.stableAsset.address).toMatch(/^0x[0-9a-fA-F]{40}$/);
+            expect(config.stableAsset.symbol.length).toBeGreaterThan(0);
+            expect(config.stableAsset.decimals).toBeGreaterThan(0);
+            expect(config.stableAsset.currencyCode).toMatch(/^[A-Z]{3}$/);
+            expect(chain).toBeTruthy();
+        }
+    });
+    it('carries the live token per deployment', () => {
+        expect(CHAIN_CONFIGS.base.stableAsset).toEqual({
+            address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+            symbol: 'USDC',
+            name: 'USD Coin',
+            decimals: 6,
+            currencyCode: 'USD',
+        });
+        expect(CHAIN_CONFIGS.xdc.stableAsset.symbol).toBe('AUDD');
+        expect(CHAIN_CONFIGS.xdc.stableAsset.currencyCode).toBe('AUD');
+        expect(CHAIN_CONFIGS['xdc-usdc'].stableAsset.symbol).toBe('USDC');
+        expect(CHAIN_CONFIGS.plume.stableAsset.symbol).toBe('pUSD');
+    });
+});
+describe('CHAIN_CONFIGS — rpcUrls', () => {
+    it('gives every live deployment at least one default endpoint', () => {
+        for (const chain of ['base', 'xdc', 'xdc-usdc']) {
+            expect(CHAIN_CONFIGS[chain].rpcUrls.length).toBeGreaterThan(0);
+            expect(CHAIN_CONFIGS[chain].retired).toBeUndefined();
+        }
+    });
+    it('never lists an XDC endpoint that fails CORS preflight', () => {
+        // `rpc.xdc.org` / `erpc.xdc.org` answer OPTIONS without
+        // `access-control-allow-origin`, so a browser call hangs. House rule.
+        for (const config of Object.values(CHAIN_CONFIGS)) {
+            for (const url of config.rpcUrls) {
+                expect(url).not.toContain('rpc.xdc.org');
+                expect(url).not.toContain('erpc.xdc.org');
+            }
+        }
+    });
+    it('marks the retired deployment and leaves it without a default RPC', () => {
+        expect(CHAIN_CONFIGS.plume.retired).toBe(true);
+        expect(CHAIN_CONFIGS.plume.rpcUrls).toEqual([]);
+    });
+});
+describe('Kasu — read-only create and connect', () => {
+    it('creates a read-only instance with no signerOrProvider', () => {
+        const kasu = Kasu.create({ chain: 'base' });
+        expect(kasu.isReadOnly).toBe(true);
+        expect(kasu.provider).toBeInstanceOf(providers.StaticJsonRpcProvider);
+    });
+    it('uses rpcUrls[0] and the config chain id, with no network detection', () => {
+        const kasu = Kasu.create({ chain: 'base' });
+        const provider = kasu.provider;
+        expect(provider.connection.url).toBe(CHAIN_CONFIGS.base.rpcUrls[0]);
+        expect(provider.network.chainId).toBe(CHAIN_CONFIGS.base.chainId);
+    });
+    it('refuses a read-only create on a retired chain with no default RPC', () => {
+        expect(() => Kasu.create({ chain: 'plume' })).toThrow('Kasu.create: chain "plume" has no default RPC (retired); pass signerOrProvider');
+    });
+    it('still accepts an explicit provider for the retired chain', () => {
+        const provider = new providers.StaticJsonRpcProvider('https://example.invalid/plume', CHAIN_CONFIGS.plume.chainId);
+        const kasu = Kasu.create({ chain: 'plume', signerOrProvider: provider });
+        expect(kasu.isReadOnly).toBe(true);
+        expect(kasu.provider).toBe(provider);
+    });
+    it('is writable when created from a signer', () => {
+        const kasu = Kasu.create({ chain: 'base', signerOrProvider: signer() });
+        expect(kasu.isReadOnly).toBe(false);
+    });
+    it('connect returns a NEW writable instance, leaving the original read-only', () => {
+        const readOnly = Kasu.create({ chain: 'base' });
+        const connected = readOnly.connect(signer());
+        expect(connected).not.toBe(readOnly);
+        expect(connected.isReadOnly).toBe(false);
+        expect(readOnly.isReadOnly).toBe(true);
+    });
+    it('connect keeps the chain config and the configOverrides', () => {
+        const readOnly = Kasu.create({
+            chain: 'base',
+            configOverrides: { UNUSED_LENDING_POOL_IDS: ['0xhidden'] },
+        });
+        const connected = readOnly.connect(signer());
+        expect(connected.chainConfig).toBe(readOnly.chainConfig);
+        const configOf = (kasu) => kasu.services.DataService
+            ._kasuConfig;
+        expect(configOf(connected).UNUSED_LENDING_POOL_IDS).toEqual([
+            '0xhidden',
+        ]);
+    });
+    it('exposes the signer’s own provider on a connected instance', () => {
+        const wallet = signer();
+        const kasu = Kasu.create({ chain: 'base', signerOrProvider: wallet });
+        expect(kasu.provider).toBe(wallet.provider);
+    });
+    it('throws rather than returning undefined for a provider-less signer', () => {
+        const kasu = Kasu.create({
+            chain: 'base',
+            signerOrProvider: Wallet.createRandom(),
+        });
+        expect(() => kasu.provider).toThrow('has no provider attached');
+    });
+});
+describe('DepositsFacade — read-only writes', () => {
+    const readOnly = () => Kasu.create({ chain: 'base' });
+    const READ_ONLY_MESSAGE = 'Kasu: this instance is read-only; call kasu.connect(signer) first';
+    it('refuses deposit before touching the contract', () => __awaiter(void 0, void 0, void 0, function* () {
+        yield expect(readOnly().deposits.deposit({
+            poolId: '0xpool',
+            trancheId: '0xtranche',
+            amount: 1,
+            kycSignature: { blockExpiration: 0, signature: '0x' },
+        })).rejects.toThrow(READ_ONLY_MESSAGE);
+    }));
+    it('refuses withdraw', () => __awaiter(void 0, void 0, void 0, function* () {
+        yield expect(readOnly().deposits.withdraw({
+            poolId: '0xpool',
+            trancheId: '0xtranche',
+            amount: 1,
+        })).rejects.toThrow(READ_ONLY_MESSAGE);
+    }));
+    it('refuses withdrawMax', () => __awaiter(void 0, void 0, void 0, function* () {
+        yield expect(readOnly().deposits.withdrawMax('0xpool', '0xtranche', '0xuser')).rejects.toThrow(READ_ONLY_MESSAGE);
+    }));
+    it('lets a connected instance past the guard', () => {
+        const connected = readOnly().connect(signer());
+        // Reaches the contract call (and fails there on a fake address) rather
+        // than being refused up front. Probing the guard directly keeps the
+        // assertion off the network.
+        const guard = connected.deposits;
+        expect(() => {
+            guard.assertWritable();
+        }).not.toThrow();
+    });
+});
+describe('Kasu.create — a ChainConfigEntry written before 2.5.0', () => {
+    // kasu-app-admin hand-builds one of these for base-sepolia. TypeScript will
+    // ask it for `stableAsset` and `rpcUrls` on bump; the runtime must not
+    // crash first.
+    const legacy = () => ({
+        chainId: 84532,
+        name: 'base-sepolia',
+        isLiteDeployment: false,
+        contracts: BASE_CONTRACTS,
+        subgraphUrl: 'https://example.invalid/subgraph',
+        // Non-empty: `SdkConfig` documents `directusUrl` as optional, but
+        // `createDirectus('')` throws `TypeError: Invalid URL`. Pre-existing,
+        // and unrelated to what this test covers.
+        directusUrl: 'https://example.invalid/directus/',
+        unusedPoolIds: [''],
+    });
+    it('constructs with an explicit provider and falls back to 6 decimals', () => {
+        const kasu = Kasu.create({
+            chain: legacy(),
+            signerOrProvider: new providers.StaticJsonRpcProvider('https://example.invalid/rpc', 84532),
+        });
+        const config = kasu.services.DataService._kasuConfig;
+        expect(config.stableAssetDecimals).toBe(6);
+    });
+    it('refuses a read-only create with the same message a retired chain gives', () => {
+        expect(() => Kasu.create({ chain: legacy() })).toThrow('Kasu.create: chain "base-sepolia" has no default RPC (retired); pass signerOrProvider');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/facade/config.test.js.map

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

package/dist/facade/deposits.d.ts

@@ -10,7 +10,28 @@ import { DepositParams, KycParams, WithdrawParams } from './types';
 export declare class DepositsFacade {
     private _userLending;
     private _chainId;
-    constructor(_userLending: UserLending, _chainId: string);
+    /**
+     * True when the SDK holds a Provider rather than a Signer. Optional and
+     * defaulting to false so constructing this facade directly keeps
+     * working; `Kasu` always passes it.
+     */
+    private _isReadOnly;
+    constructor(_userLending: UserLending, _chainId: string, 
+    /**
+     * True when the SDK holds a Provider rather than a Signer. Optional and
+     * defaulting to false so constructing this facade directly keeps
+     * working; `Kasu` always passes it.
+     */
+    _isReadOnly?: boolean);
+    /**
+     * Refuse a write BEFORE touching the contract.
+     *
+     * ethers would throw its own "sending a transaction requires a signer" a
+     * few frames deeper, after the params have been encoded — a message that
+     * says nothing about how to get a signer onto THIS object. Failing here
+     * names the fix.
+     */
+    private assertWritable;
     /**
      * Submit a deposit request.
      *

package/dist/facade/deposits.js

@@ -14,9 +14,29 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
  * worrying about internal encoding details.
  */
 export class DepositsFacade {
-    constructor(_userLending, _chainId) {
+    constructor(_userLending, _chainId, 
+    /**
+     * True when the SDK holds a Provider rather than a Signer. Optional and
+     * defaulting to false so constructing this facade directly keeps
+     * working; `Kasu` always passes it.
+     */
+    _isReadOnly = false) {
         this._userLending = _userLending;
         this._chainId = _chainId;
+        this._isReadOnly = _isReadOnly;
+    }
+    /**
+     * Refuse a write BEFORE touching the contract.
+     *
+     * ethers would throw its own "sending a transaction requires a signer" a
+     * few frames deeper, after the params have been encoded — a message that
+     * says nothing about how to get a signer onto THIS object. Failing here
+     * names the fix.
+     */
+    assertWritable() {
+        if (this._isReadOnly) {
+            throw new Error('Kasu: this instance is read-only; call kasu.connect(signer) first');
+        }
     }
     /**
      * Submit a deposit request.
@@ -38,6 +58,7 @@ export class DepositsFacade {
     deposit(params) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;
+            this.assertWritable();
             return yield this._userLending.requestDepositWithKyc(params.poolId, params.trancheId, params.amount, (_a = params.swapData) !== null && _a !== void 0 ? _a : '0x', (_b = params.fixedTermConfigId) !== null && _b !== void 0 ? _b : 0, (_c = params.depositData) !== null && _c !== void 0 ? _c : '0x', params.kycSignature, (_d = params.ethValue) !== null && _d !== void 0 ? _d : '0');
         });
     }
@@ -46,6 +67,7 @@ export class DepositsFacade {
      */
     withdraw(params) {
         return __awaiter(this, void 0, void 0, function* () {
+            this.assertWritable();
             return yield this._userLending.requestWithdrawalInAsset(params.poolId, params.trancheId, params.amount);
         });
     }
@@ -54,6 +76,7 @@ export class DepositsFacade {
      */
     withdrawMax(poolId, trancheId, userAddress) {
         return __awaiter(this, void 0, void 0, function* () {
+            this.assertWritable();
             return yield this._userLending.requestWithdrawalMax(poolId, trancheId, userAddress);
         });
     }