@kasufinance/kasu-sdk 2.6.0 → 2.7.0

package/src/domain/loan-contract.test.ts

@@ -1,343 +0,0 @@
-import { ethers } from 'ethers';
-
-import {
-    asContractType,
-    buildContractVersionType,
-    buildFullNameRequestMessage,
-    buildLegacyContractRequestMessage,
-    buildLoanAgreementSignMessage,
-    ContractType,
-    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: string;
-    signature: string;
-    timestamp: number;
-    contractVersion: number;
-    contractType: ContractType;
-    expected: string;
-}[] = [
-    {
-        name: 'v1 retail, ms timestamp',
-        signature: SIG_65,
-        timestamp: 1_700_000_000_000,
-        contractVersion: 1,
-        contractType: 'retail',
-        expected:
-            '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000018bcfe5680000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000041deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1c00000000000000000000000000000000000000000000000000000000000000',
-    },
-    {
-        name: 'v1 exempt, ms timestamp',
-        signature: SIG_65,
-        timestamp: 1_700_000_000_000,
-        contractVersion: 1,
-        contractType: 'exempt',
-        expected:
-            '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000018bcfe5680000000000000000000000000000000000000000000000000000000000000001010000000000000000000000000000000000000000000000000000000000000041deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef1c00000000000000000000000000000000000000000000000000000000000000',
-    },
-    {
-        name: 'v2 retail, deck timestamp',
-        signature: SIG_65_B,
-        timestamp: 1_785_313_320_000,
-        contractVersion: 2,
-        contractType: 'retail',
-        expected:
-            '0x00000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000019facf75c40000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000414a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f84a1e2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f81b00000000000000000000000000000000000000000000000000000000000000',
-    },
-    {
-        name: 'v2 exempt, deck timestamp',
-        signature: SIG_65_B,
-        timestamp: 1_785_313_320_000,
-        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: 1_700_000_000_000,
-            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: 1_700_000_000_000,
-            contractVersion: 1,
-            contractType: 'exempt',
-        });
-        const [sigOut, tsOut, vtOut] = ethers.utils.defaultAbiCoder.decode(
-            ['bytes', 'uint256', 'uint256'],
-            out,
-        ) as [string, ethers.BigNumber, ethers.BigNumber];
-        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: ContractType): string => {
-            const [, , v] = ethers.utils.defaultAbiCoder.decode(
-                ['bytes', 'uint256', 'uint256'],
-                encodeDepositData({
-                    signature: SIG_65,
-                    timestamp: 1,
-                    contractVersion: 1,
-                    contractType,
-                }),
-            ) as [string, ethers.BigNumber, ethers.BigNumber];
-            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?.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');
-    });
-});

package/src/domain/partners.test.ts

@@ -1,83 +0,0 @@
-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();
-    });
-});

package/src/domain/pools.test.ts

@@ -1,260 +0,0 @@
-import { PoolOverview, TrancheData } from '../services/DataService/types';
-
-import {
-    maxNetRateCeiling,
-    pickHighestYieldTranche,
-    poolMaxApy,
-    selectVisiblePools,
-} from './pools';
-import { netEffectiveApy } from './rates';
-
-/**
- * Ported from kasu-ui `select-visible-pools.test.ts` and the
- * `pickHighestYieldTranche` / `formatMaxNetRate` cases of
- * `pick-best-tranche.test.ts`. The `formatMaxNetRate` assertions are on the
- * ceiling NUMBER here; their rendered strings stay in kasu-ui.
- */
-
-function tranche(
-    name: string,
-    apy: string,
-    poolCapacity: string,
-    maxApy?: string,
-): TrancheData {
-    return { id: name, name, apy, poolCapacity, maxApy } as unknown as TrancheData;
-}
-
-function pool(over: Partial<PoolOverview>): PoolOverview {
-    return {
-        id: 'p',
-        poolName: 'p',
-        isActive: true,
-        isOversubscribed: false,
-        tranches: [tranche('Senior', '0.09', '250000', '0.10')],
-        ...over,
-    } as unknown as PoolOverview;
-}
-
-const withCapacity = (): TrancheData[] => [
-    tranche('Senior', '0.09', '250000', '0.10'),
-];
-const noCapacity = (): TrancheData[] => [tranche('Senior', '0.09', '0', '0.10')];
-
-/** The live performance fee on all deployments. */
-const FEE = 10;
-
-describe('poolMaxApy', () => {
-    it('takes the highest usable maxApy across tranches', () => {
-        expect(
-            poolMaxApy(
-                pool({
-                    tranches: [
-                        tranche('Senior', '0.09', '1', '0.10'),
-                        tranche('Junior', '0.12', '1', '0.18'),
-                    ],
-                }),
-            ),
-        ).toBe(0.18);
-    });
-
-    it('is 0 when nothing is usable', () => {
-        expect(poolMaxApy(pool({ tranches: [] }))).toBe(0);
-        expect(
-            poolMaxApy(pool({ tranches: [tranche('Senior', '0.09', '1', 'x')] })),
-        ).toBe(0);
-    });
-});
-
-describe('selectVisiblePools', () => {
-    it('drops inactive pools', () => {
-        const pools = [
-            pool({ id: 'active', isActive: true }),
-            pool({ id: 'inactive', isActive: false }),
-        ];
-        expect(selectVisiblePools(pools).map((p) => p.id)).toEqual(['active']);
-    });
-
-    it('drops oversubscribed pools', () => {
-        const pools = [
-            pool({ id: 'open', isOversubscribed: false }),
-            pool({ id: 'full', isOversubscribed: true }),
-        ];
-        expect(selectVisiblePools(pools).map((p) => p.id)).toEqual(['open']);
-    });
-
-    it('sorts pools with capacity ahead of pools without', () => {
-        const pools = [
-            pool({ id: 'empty', tranches: noCapacity() }),
-            pool({ id: 'has-cap', tranches: withCapacity() }),
-        ];
-        expect(selectVisiblePools(pools).map((p) => p.id)).toEqual([
-            'has-cap',
-            'empty',
-        ]);
-    });
-
-    it('sorts by highest max APY within the same capacity bucket', () => {
-        const pools = [
-            pool({
-                id: 'low',
-                tranches: [tranche('Senior', '0.08', '250000', '0.08')],
-            }),
-            pool({
-                id: 'high',
-                tranches: [tranche('Senior', '0.15', '250000', '0.15')],
-            }),
-        ];
-        expect(selectVisiblePools(pools).map((p) => p.id)).toEqual([
-            'high',
-            'low',
-        ]);
-    });
-
-    it('does not mutate the input array', () => {
-        const pools = [
-            pool({ id: 'a', tranches: noCapacity() }),
-            pool({ id: 'b', tranches: withCapacity() }),
-        ];
-        const before = pools.map((p) => p.id);
-        selectVisiblePools(pools);
-        expect(pools.map((p) => p.id)).toEqual(before);
-    });
-});
-
-describe('pickHighestYieldTranche', () => {
-    const named = (poolName: string, tranches: TrancheData[]): PoolOverview =>
-        pool({ id: poolName, poolName, tranches });
-
-    it('returns null for empty / nullish input', () => {
-        expect(pickHighestYieldTranche(undefined)).toBeNull();
-        expect(pickHighestYieldTranche(null)).toBeNull();
-        expect(pickHighestYieldTranche([])).toBeNull();
-    });
-
-    it('picks the highest base APY across all pools with capacity', () => {
-        const best = pickHighestYieldTranche([
-            named('A', [tranche('Junior', '0.12', '5000')]),
-            named('B', [
-                tranche('Senior', '0.18', '5000'),
-                tranche('Mezz', '0.15', '5000'),
-            ]),
-        ]);
-        expect(best?.pool.poolName).toBe('B');
-        expect(best?.tranche.name).toBe('Senior');
-        expect(best?.apy).toBeCloseTo(0.18);
-    });
-
-    it('skips tranches without capacity (< 1 unit)', () => {
-        const best = pickHighestYieldTranche([
-            named('Full', [tranche('Junior', '0.30', '0')]),
-            named('Live', [tranche('Senior', '0.10', '2000')]),
-        ]);
-        expect(best?.pool.poolName).toBe('Live');
-        expect(best?.apy).toBeCloseTo(0.1);
-    });
-
-    it('breaks APY ties toward more remaining capacity', () => {
-        const best = pickHighestYieldTranche([
-            named('Small', [tranche('Junior', '0.15', '1000')]),
-            named('Big', [tranche('Junior', '0.15', '9000')]),
-        ]);
-        expect(best?.pool.poolName).toBe('Big');
-    });
-
-    it('ignores zero / non-finite APY values', () => {
-        const best = pickHighestYieldTranche([
-            named('Zero', [tranche('Junior', '0', '5000')]),
-            named('NaN', [tranche('Junior', 'not-a-number', '5000')]),
-            named('Real', [tranche('Junior', '0.09', '5000')]),
-        ]);
-        expect(best?.pool.poolName).toBe('Real');
-    });
-
-    it('reads the BASE rate, not the FTD-widened maxApy', () => {
-        // A ceiling claim and a named tranche's rate are different statements.
-        const best = pickHighestYieldTranche([
-            named('A', [tranche('Junior', '0.12', '5000', '0.30')]),
-            named('B', [tranche('Senior', '0.18', '5000', '0.18')]),
-        ]);
-        expect(best?.pool.poolName).toBe('B');
-    });
-});
-
-describe('maxNetRateCeiling', () => {
-    const named = (poolName: string, tranches: TrancheData[]): PoolOverview =>
-        pool({ id: poolName, poolName, tranches });
-
-    it('returns the highest ceiling across all pools, net of the fee', () => {
-        const rate = maxNetRateCeiling(
-            [
-                named('A', [tranche('Junior', '0.12', '5000', '0.18')]),
-                named('B', [tranche('Senior', '0.10', '5000', '0.22')]),
-            ],
-            FEE,
-        );
-        // 0.22 gross → 19.60% net, the same arithmetic as everywhere else.
-        expect(rate).toBe(netEffectiveApy(0.22, FEE));
-        expect(rate).toBeCloseTo(0.196, 4);
-    });
-
-    it('prefers the FTD-inclusive maxApy over the base rate', () => {
-        // The strategies card's range tops out at maxApy; an "up to" claim
-        // quoting the base rate would contradict it on the same screen.
-        expect(
-            maxNetRateCeiling(
-                [named('A', [tranche('Junior', '0.10', '5000', '0.22')])],
-                FEE,
-            ),
-        ).toBe(netEffectiveApy(0.22, FEE));
-    });
-
-    it('falls back to the base rate when a tranche carries no maxApy', () => {
-        expect(
-            maxNetRateCeiling(
-                [named('A', [tranche('Junior', '0.22', '5000')])],
-                FEE,
-            ),
-        ).toBe(netEffectiveApy(0.22, FEE));
-    });
-
-    it('skips tranches without capacity — an unreachable rate is not a claim', () => {
-        const rate = maxNetRateCeiling(
-            [
-                named('Full', [tranche('Junior', '0.30', '0', '0.30')]),
-                named('Live', [tranche('Senior', '0.10', '5000', '0.10')]),
-            ],
-            FEE,
-        );
-        expect(rate).toBe(netEffectiveApy(0.1, FEE));
-        expect(rate).toBeCloseTo(0.0896, 4);
-    });
-
-    it('returns null rather than a gross figure when the fee is out of domain', () => {
-        const pools = [named('A', [tranche('Junior', '0.22', '5000', '0.22')])];
-        expect(maxNetRateCeiling(pools, 1000)).toBeNull();
-        expect(maxNetRateCeiling(pools, -1)).toBeNull();
-        expect(maxNetRateCeiling(pools, NaN)).toBeNull();
-        // A 100% fee leaves nothing to claim.
-        expect(maxNetRateCeiling(pools, 100)).toBeNull();
-    });
-
-    it('returns null for empty, nullish or rate-less input', () => {
-        expect(maxNetRateCeiling(undefined, FEE)).toBeNull();
-        expect(maxNetRateCeiling(null, FEE)).toBeNull();
-        expect(maxNetRateCeiling([], FEE)).toBeNull();
-        expect(
-            maxNetRateCeiling(
-                [named('Zero', [tranche('Junior', '0', '5000', '0')])],
-                FEE,
-            ),
-        ).toBeNull();
-    });
-
-    it('agrees with the top of the tranche range it must sit alongside', () => {
-        // Both read maxApy through netEffectiveApy; they must not disagree.
-        const tranches = [tranche('Senior', '0.14', '5000', '0.22')];
-        expect(maxNetRateCeiling([named('A', tranches)], FEE)).toBe(
-            netEffectiveApy(0.22, FEE),
-        );
-    });
-});