@kasufinance/kasu-sdk 2.4.2 → 2.6.0

package/dist/domain/loan-contract.js.map

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

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

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

package/dist/domain/loan-contract.test.js

@@ -0,0 +1,255 @@
+import { ethers } from 'ethers';
+import { asContractType, buildContractVersionType, buildFullNameRequestMessage, buildLegacyContractRequestMessage, buildLoanAgreementSignMessage, encodeDepositData, formatSignTimestampUtc, parseFormattedMessage, } from './loan-contract';
+/**
+ * Ported from kasu-ui `src/features/lending/lib/encode-deposit-data.test.ts`
+ * and `sign-message.test.ts`.
+ *
+ * PINNED CROSS-REPO CONTRACT. The expected strings and byte strings here are
+ * what kasu-backend reconstructs and verifies against. A diff in this file
+ * without a matching kasu-backend diff means signatures stop verifying in
+ * production.
+ */
+describe('buildContractVersionType', () => {
+    it('packs version 1 retail as 0x0100 (256)', () => {
+        expect(buildContractVersionType(1, 'retail')).toBe(256);
+    });
+    it('packs version 1 exempt as 0x0101 (257)', () => {
+        expect(buildContractVersionType(1, 'exempt')).toBe(257);
+    });
+    it('packs version 0 retail as 0', () => {
+        expect(buildContractVersionType(0, 'retail')).toBe(0);
+    });
+    it('packs version 2 exempt as 0x0201 (513)', () => {
+        expect(buildContractVersionType(2, 'exempt')).toBe(513);
+    });
+});
+const SIG_65 = '0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef' +
+    'deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1c';
+const SIG_65_B = '0x4a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f8' +
+    '4a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f81b';
+/**
+ * BYTE FIXTURES — produced by the viem implementation kasu-ui runs
+ * (`encodeAbiParameters(parseAbiParameters('bytes, uint256, uint256'), …)`)
+ * and pasted here verbatim. This is the whole point of the port: the ethers v5
+ * encoder in `loan-contract.ts` must emit exactly these bytes, because kasu-ui
+ * and kasu-mobile write the same `depositData` field on the same contract.
+ *
+ * Covers both contract types, a contract version >= 2, a short signature and
+ * the empty-signature/zero-timestamp floor.
+ */
+const VIEM_FIXTURES = [
+    {
+        name: 'v1 retail, ms timestamp',
+        signature: SIG_65,
+        timestamp: 1700000000000,
+        contractVersion: 1,
+        contractType: 'retail',
+        expected: '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000018bcfe5680000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000041deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1c00000000000000000000000000000000000000000000000000000000000000',
+    },
+    {
+        name: 'v1 exempt, ms timestamp',
+        signature: SIG_65,
+        timestamp: 1700000000000,
+        contractVersion: 1,
+        contractType: 'exempt',
+        expected: '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000018bcfe5680000000000000000000000000000000000000000000000000000000000000001010000000000000000000000000000000000000000000000000000000000000041deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1c00000000000000000000000000000000000000000000000000000000000000',
+    },
+    {
+        name: 'v2 retail, deck timestamp',
+        signature: SIG_65_B,
+        timestamp: 1785313320000,
+        contractVersion: 2,
+        contractType: 'retail',
+        expected: '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000019facf75c40000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000414a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f84a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f81b00000000000000000000000000000000000000000000000000000000000000',
+    },
+    {
+        name: 'v2 exempt, deck timestamp',
+        signature: SIG_65_B,
+        timestamp: 1785313320000,
+        contractVersion: 2,
+        contractType: 'exempt',
+        expected: '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000019facf75c40000000000000000000000000000000000000000000000000000000000000020100000000000000000000000000000000000000000000000000000000000000414a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f84a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f81b00000000000000000000000000000000000000000000000000000000000000',
+    },
+    {
+        name: 'short signature, v3 exempt, timestamp 1',
+        signature: '0x1234',
+        timestamp: 1,
+        contractVersion: 3,
+        contractType: 'exempt',
+        expected: '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000030100000000000000000000000000000000000000000000000000000000000000021234000000000000000000000000000000000000000000000000000000000000',
+    },
+    {
+        name: 'empty signature, v0 retail, timestamp 0',
+        signature: '0x',
+        timestamp: 0,
+        contractVersion: 0,
+        contractType: 'retail',
+        expected: '0x0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000',
+    },
+];
+describe('encodeDepositData — byte-identical to the viem implementation', () => {
+    for (const fixture of VIEM_FIXTURES) {
+        it(`matches the viem fixture: ${fixture.name}`, () => {
+            expect(encodeDepositData({
+                signature: fixture.signature,
+                timestamp: fixture.timestamp,
+                contractVersion: fixture.contractVersion,
+                contractType: fixture.contractType,
+            })).toBe(fixture.expected);
+        });
+    }
+    it('produces a 0x-prefixed hex string', () => {
+        const out = encodeDepositData({
+            signature: SIG_65,
+            timestamp: 1700000000000,
+            contractVersion: 1,
+            contractType: 'retail',
+        });
+        expect(out).toMatch(/^0x[0-9a-f]+$/i);
+    });
+    it('round-trips through the same ABI tuple', () => {
+        const out = encodeDepositData({
+            signature: SIG_65,
+            timestamp: 1700000000000,
+            contractVersion: 1,
+            contractType: 'exempt',
+        });
+        const [sigOut, tsOut, vtOut] = ethers.utils.defaultAbiCoder.decode(['bytes', 'uint256', 'uint256'], out);
+        expect(sigOut).toBe(SIG_65);
+        expect(tsOut.toString()).toBe('1700000000000');
+        expect(vtOut.toString()).toBe('257'); // version 1 exempt
+    });
+    it('encodes retail with low-byte 0 and exempt with low-byte 1', () => {
+        const vt = (contractType) => {
+            const [, , v] = ethers.utils.defaultAbiCoder.decode(['bytes', 'uint256', 'uint256'], encodeDepositData({
+                signature: SIG_65,
+                timestamp: 1,
+                contractVersion: 1,
+                contractType,
+            }));
+            return v.toString();
+        };
+        expect(vt('retail')).toBe('256');
+        expect(vt('exempt')).toBe('257');
+    });
+});
+describe('formatSignTimestampUtc', () => {
+    // 29 July 2026, 08:22:00 UTC.
+    const ms = 1785313320000; // 13 digits → milliseconds
+    const seconds = 1785313320; // 10 digits → seconds
+    it('formats a millisecond timestamp (>= 13 digits)', () => {
+        expect(formatSignTimestampUtc(ms)).toBe('29 July 2026, 08:22');
+    });
+    it('formats a second timestamp (< 13 digits) to the same instant', () => {
+        expect(formatSignTimestampUtc(seconds)).toBe('29 July 2026, 08:22');
+    });
+    it('pads hour/minute but not the day, at a month-boundary midnight', () => {
+        // 1 August 2026, 00:05:00 UTC — day non-padded ("1"), minute padded.
+        const midnight = Date.UTC(2026, 7, 1, 0, 5, 0);
+        expect(formatSignTimestampUtc(midnight)).toBe('1 August 2026, 00:05');
+    });
+});
+describe('buildLoanAgreementSignMessage', () => {
+    it('builds the exact 4-line message from a millisecond timestamp', () => {
+        expect(buildLoanAgreementSignMessage({
+            strategyName: 'Taxation Funding (Tax Pay)',
+            region: 'Australia',
+            optionName: 'Upper Mezzanine',
+            amountLabel: '500 AUDD',
+            timestamp: 1785313320000,
+        })).toBe('Generate my Loan Agreement for review:\n' +
+            'Taxation Funding (Tax Pay) · Australia · Upper Mezzanine · 500 AUDD.\n' +
+            'Request made 29 July 2026, 08:22 UTC.\n' +
+            'This request does not commit me to lend.');
+    });
+    it('builds the identical message from the equivalent second timestamp', () => {
+        expect(buildLoanAgreementSignMessage({
+            strategyName: 'Whole Ledger Funding',
+            region: 'Australia',
+            optionName: 'Mezzanine',
+            amountLabel: '1,260.37 USDC',
+            timestamp: 1785313320, // seconds form of the same instant
+        })).toBe('Generate my Loan Agreement for review:\n' +
+            'Whole Ledger Funding · Australia · Mezzanine · 1,260.37 USDC.\n' +
+            'Request made 29 July 2026, 08:22 UTC.\n' +
+            'This request does not commit me to lend.');
+    });
+    it('formats a month-boundary/midnight request line', () => {
+        expect(buildLoanAgreementSignMessage({
+            strategyName: 'Professional Fee Funding',
+            region: 'Australia',
+            optionName: 'Junior',
+            amountLabel: '10 USDC',
+            timestamp: Date.UTC(2026, 7, 1, 0, 5, 0),
+        })).toBe('Generate my Loan Agreement for review:\n' +
+            'Professional Fee Funding · Australia · Junior · 10 USDC.\n' +
+            'Request made 1 August 2026, 00:05 UTC.\n' +
+            'This request does not commit me to lend.');
+    });
+    it('separates the line-2 fields with U+00B7 surrounded by single spaces', () => {
+        const message = buildLoanAgreementSignMessage({
+            strategyName: 'A',
+            region: 'B',
+            optionName: 'C',
+            amountLabel: 'D',
+            timestamp: 1785313320000,
+        });
+        expect(message.split('\n')[1]).toBe('A · B · C · D.');
+        expect(message.split('\n')).toHaveLength(4);
+    });
+});
+describe('buildLegacyContractRequestMessage', () => {
+    const ADDRESS = '0x4c0d92e9c862B58b0FFeAAD031004A049d2c360D';
+    it('builds the exact legacy template with a lowercased address', () => {
+        expect(buildLegacyContractRequestMessage(ADDRESS, 1785313320000)).toBe('I request contract content for ' +
+            '0x4c0d92e9c862b58b0ffeaad031004a049d2c360d at 1785313320000.');
+    });
+    it('is insensitive to the casing the caller hands over', () => {
+        expect(buildLegacyContractRequestMessage(ADDRESS, 1)).toBe(buildLegacyContractRequestMessage(ADDRESS.toLowerCase(), 1));
+    });
+    it('prints the timestamp verbatim — no seconds/ms normalisation', () => {
+        // The backend echoes the body's `timestamp` into the string it
+        // verifies, so whatever is signed must be what is sent.
+        expect(buildLegacyContractRequestMessage(ADDRESS, 1785313320)).toBe('I request contract content for ' +
+            '0x4c0d92e9c862b58b0ffeaad031004a049d2c360d at 1785313320.');
+    });
+});
+describe('buildFullNameRequestMessage', () => {
+    const ADDRESS = '0x26b5b8060A704b0420734d5Ccd657384fb1366C2';
+    it('builds the exact full-name template with a lowercased address', () => {
+        expect(buildFullNameRequestMessage(ADDRESS, 1785313320000)).toBe('I request my full name for ' +
+            '0x26b5b8060a704b0420734d5ccd657384fb1366c2 at 1785313320000.');
+    });
+    it('is a different message from the contract-content one', () => {
+        expect(buildFullNameRequestMessage(ADDRESS, 1)).not.toBe(buildLegacyContractRequestMessage(ADDRESS, 1));
+    });
+});
+describe('parseFormattedMessage', () => {
+    it('parses the server’s JSON-encoded tree', () => {
+        const parsed = parseFormattedMessage(JSON.stringify({ intro: 'x', 'subheader-1': { title: 't' } }));
+        expect(parsed === null || parsed === void 0 ? void 0 : parsed.intro).toBe('x');
+    });
+    it('returns null on malformed JSON so a renderer can fall back', () => {
+        expect(parseFormattedMessage('not json')).toBeNull();
+        expect(parseFormattedMessage('')).toBeNull();
+    });
+    it('returns null for a JSON scalar, which is not a contract tree', () => {
+        expect(parseFormattedMessage('42')).toBeNull();
+        expect(parseFormattedMessage('null')).toBeNull();
+        expect(parseFormattedMessage('"a string"')).toBeNull();
+    });
+});
+describe('asContractType', () => {
+    it('narrows the wire string to the two encoded types', () => {
+        expect(asContractType('exempt')).toBe('exempt');
+        expect(asContractType('retail')).toBe('retail');
+    });
+    it('falls back to retail for anything else', () => {
+        // Retail is the stricter contract; an unrecognised type must not be
+        // silently treated as the exempt one.
+        expect(asContractType('')).toBe('retail');
+        expect(asContractType('Exempt')).toBe('retail');
+        expect(asContractType('whatever')).toBe('retail');
+    });
+});
+//# sourceMappingURL=loan-contract.test.js.map

package/dist/domain/loan-contract.test.js.map

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

package/dist/domain/partners.d.ts

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

package/dist/domain/partners.js

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

package/dist/domain/partners.js.map

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

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

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

package/dist/domain/partners.test.js

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

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

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

package/dist/domain/pools.d.ts

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

package/dist/domain/pools.js

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

package/dist/domain/pools.js.map

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

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

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