@kasufinance/kasu-sdk 2.4.2 → 2.6.0

package/dist/domain/au-minimum.d.ts

@@ -0,0 +1,135 @@
+/**
+ * The AU cumulative-lending minimum — the numeric half.
+ *
+ * RULE: a lender whose verified KYC country is Australia may only lend when
+ * their existing deposited position on THIS deployment, plus the amount they
+ * are asking for, reaches the deployment's threshold.
+ *
+ * This is UX PRE-VALIDATION ONLY. kasu-backend enforces the rule
+ * authoritatively at contract generation and refuses with HTTP 403
+ * `AU_WHOLESALE_MINIMUM_NOT_MET`; a lender who gets past this check is still
+ * stopped there. What these helpers exist for is to raise the amount field's
+ * minimum so the lender learns the rule while typing rather than at the end.
+ *
+ * FAIL-OPEN by design: an absent or unknown country is NOT restricted, and an
+ * unlisted stable symbol has no threshold. An UNKNOWN existing position is
+ * treated as 0 — strict, so the floor is never advertised lower than the
+ * backend will accept, and it relaxes once the position loads.
+ *
+ * Arithmetic is integer bigint in minor units (10^decimals) so no two
+ * consumers can disagree at the boundary. Parsing TRUNCATES, never rounds up —
+ * a position can never be inflated into passing. `BigInt(...)` calls only, no
+ * bigint literals, so consumers on an older target still compile.
+ *
+ * Lifted from kasu-ui's `features/lending/lib/au-lending-restriction.ts`. The
+ * two toast strings that live there are copy and stay in the applications.
+ */
+type Maybe<T> = T | null | undefined;
+type NumLike = string | number | null | undefined;
+/** ISO 3166-1 alpha-3 for Australia — the collapsed KYC country field. */
+export declare const AU_ALPHA3 = "AUS";
+/**
+ * Is this the Australian KYC country? Case-insensitive and
+ * whitespace-tolerant. Anything that is not a string — including the
+ * `undefined` of an unloaded KYC record — is not restricted (fail-open).
+ *
+ * The alpha-2 `'AU'` deliberately does NOT match: the KYC country reaching
+ * this rule is normalised to alpha-3 upstream, and a bare two-letter code
+ * here means something else went wrong.
+ */
+export declare function isAustralianKyc(country: Maybe<string>): boolean;
+/**
+ * Minimum CUMULATIVE position, in WHOLE stable units, keyed on the
+ * deployment's stable-asset symbol (a property of the currency, not the
+ * chain). Must match kasu-backend's table exactly.
+ */
+export declare const AU_MIN_CUMULATIVE_BY_STABLE: Readonly<Record<string, number>>;
+/**
+ * Threshold in whole units, or `undefined` for an unlisted stable — a
+ * deployment whose currency has no configured minimum is unrestricted.
+ */
+export declare function auThresholdFor(symbol: Maybe<string>): number | undefined;
+/**
+ * Is this wallet released from the minimum entirely, whatever its country,
+ * stable or position says?
+ *
+ * `exemptAddresses` is DEPLOYMENT CONFIGURATION the caller supplies, not a
+ * constant of this package. kasu-sdk is published publicly; the exempt list is
+ * a compliance carve-out naming particular lender wallets, so it does not
+ * belong in a public tarball. Read it from wherever the application keeps its
+ * deployment configuration, and keep it identical to kasu-backend's
+ * `AU_WHOLESALE_EXEMPT_ADDRESSES` — that is where the rule is actually
+ * enforced. An address exempt here but not there sees no raised minimum in the
+ * form and is refused at the end, which is worse than not exempting it at all.
+ *
+ * The address matched must be the CONNECTED wallet — the one that owns the KYC
+ * record and signs the agreement request. kasu-backend verifies that signature
+ * before the gate, so an exemption cannot be claimed by asserting someone
+ * else's address; it takes their private key. Never match a "view as" address.
+ *
+ * Comparison is case-insensitive and whitespace-tolerant. Anything that is not
+ * a string is NOT exempt (fail closed), and so is anything when the list is
+ * absent.
+ */
+export declare function isAuMinimumExempt(address: Maybe<string>, exemptAddresses: Maybe<readonly string[]>): boolean;
+/**
+ * Truncating, partial-input-tolerant decimal → minor-unit parse.
+ * `'10.'` → `10000000n` · `'1.23456789'` → `1234567n` (truncated at 6dp).
+ * `''` / `'abc'` / negative / null → `null`.
+ *
+ * Tolerant of mid-typing states because it runs on an amount field as the
+ * lender types, and truncating because rounding up would let a position that
+ * is a fraction short read as passing.
+ */
+export declare function parseMinorUnits(value: NumLike, decimals: number): bigint | null;
+export interface AuMinimumInput {
+    /** Collapsed KYC country (alpha-3). Missing/undefined ⇒ not restricted. */
+    country: Maybe<string>;
+    /**
+     * The CONNECTED wallet (never a "view as" override).
+     *
+     * REQUIRED KEY, nullable value. A caller with no wallet passes `undefined`
+     * and gets the un-exempted behaviour; what it may not do is silently omit
+     * the key. Optional would let a refactor of the call site drop it with no
+     * compile error — and because a form's own minimum validation refuses a
+     * submit below the floor, an exempt lender would then be stopped HERE and
+     * never reach the backend that would have let them through.
+     */
+    address: Maybe<string>;
+    /**
+     * The deployment's exempt wallets — see `isAuMinimumExempt`. REQUIRED KEY
+     * for the same reason `address` is: a caller that has no list passes
+     * `undefined` deliberately, and no refactor can drop it by accident.
+     */
+    exemptAddresses: Maybe<readonly string[]>;
+    /** Deployment stable-asset symbol, e.g. `'USDC'` / `'AUDD'`. */
+    stableSymbol: Maybe<string>;
+    /** Stable-asset decimals (6 on every current deployment). */
+    decimals: number;
+    /**
+     * Existing position (active + pending) on THIS deployment, whole units.
+     * Unparseable/undefined ⇒ treated as 0 (strict: the full threshold applies
+     * until the position is known).
+     */
+    existingDeposited: NumLike;
+}
+/**
+ * The amount, in WHOLE stable units, an Australian lender still needs in order
+ * to reach the deployment's cumulative minimum. Apply it as the amount field's
+ * floor via `max(trancheMin, auMinimumRemaining(...))`.
+ *
+ * Returns 0 for everyone the rule does not restrict (fail-open), 0 for an
+ * exempt address, and 0 once the lender's existing position already satisfies
+ * the threshold.
+ *
+ * The exemption is tested FIRST and unconditionally: an exempt wallet has no
+ * minimum whatever its country, stable or position says. kasu-backend
+ * deliberately tests country first and the exemption second — the two orders
+ * are not in conflict, both return "no minimum" for the same inputs. There,
+ * the exemption sets a flag that drives a compliance log, so it must not fire
+ * for a lender the rule never engaged for. Here nothing is logged, so
+ * exemption-first is preferred: it makes this function right on its own,
+ * whatever country a caller happens to pass.
+ */
+export declare function auMinimumRemaining(input: AuMinimumInput): number;
+export {};

package/dist/domain/au-minimum.js

@@ -0,0 +1,154 @@
+/**
+ * The AU cumulative-lending minimum — the numeric half.
+ *
+ * RULE: a lender whose verified KYC country is Australia may only lend when
+ * their existing deposited position on THIS deployment, plus the amount they
+ * are asking for, reaches the deployment's threshold.
+ *
+ * This is UX PRE-VALIDATION ONLY. kasu-backend enforces the rule
+ * authoritatively at contract generation and refuses with HTTP 403
+ * `AU_WHOLESALE_MINIMUM_NOT_MET`; a lender who gets past this check is still
+ * stopped there. What these helpers exist for is to raise the amount field's
+ * minimum so the lender learns the rule while typing rather than at the end.
+ *
+ * FAIL-OPEN by design: an absent or unknown country is NOT restricted, and an
+ * unlisted stable symbol has no threshold. An UNKNOWN existing position is
+ * treated as 0 — strict, so the floor is never advertised lower than the
+ * backend will accept, and it relaxes once the position loads.
+ *
+ * Arithmetic is integer bigint in minor units (10^decimals) so no two
+ * consumers can disagree at the boundary. Parsing TRUNCATES, never rounds up —
+ * a position can never be inflated into passing. `BigInt(...)` calls only, no
+ * bigint literals, so consumers on an older target still compile.
+ *
+ * Lifted from kasu-ui's `features/lending/lib/au-lending-restriction.ts`. The
+ * two toast strings that live there are copy and stay in the applications.
+ */
+const ZERO = BigInt(0);
+/** ISO 3166-1 alpha-3 for Australia — the collapsed KYC country field. */
+export const AU_ALPHA3 = 'AUS';
+/**
+ * Is this the Australian KYC country? Case-insensitive and
+ * whitespace-tolerant. Anything that is not a string — including the
+ * `undefined` of an unloaded KYC record — is not restricted (fail-open).
+ *
+ * The alpha-2 `'AU'` deliberately does NOT match: the KYC country reaching
+ * this rule is normalised to alpha-3 upstream, and a bare two-letter code
+ * here means something else went wrong.
+ */
+export function isAustralianKyc(country) {
+    if (typeof country !== 'string')
+        return false;
+    return country.trim().toUpperCase() === AU_ALPHA3;
+}
+/**
+ * Minimum CUMULATIVE position, in WHOLE stable units, keyed on the
+ * deployment's stable-asset symbol (a property of the currency, not the
+ * chain). Must match kasu-backend's table exactly.
+ */
+export const AU_MIN_CUMULATIVE_BY_STABLE = {
+    USDC: 360000,
+    AUDD: 500000,
+};
+/**
+ * Threshold in whole units, or `undefined` for an unlisted stable — a
+ * deployment whose currency has no configured minimum is unrestricted.
+ */
+export function auThresholdFor(symbol) {
+    if (typeof symbol !== 'string')
+        return undefined;
+    return AU_MIN_CUMULATIVE_BY_STABLE[symbol.trim().toUpperCase()];
+}
+/**
+ * Is this wallet released from the minimum entirely, whatever its country,
+ * stable or position says?
+ *
+ * `exemptAddresses` is DEPLOYMENT CONFIGURATION the caller supplies, not a
+ * constant of this package. kasu-sdk is published publicly; the exempt list is
+ * a compliance carve-out naming particular lender wallets, so it does not
+ * belong in a public tarball. Read it from wherever the application keeps its
+ * deployment configuration, and keep it identical to kasu-backend's
+ * `AU_WHOLESALE_EXEMPT_ADDRESSES` — that is where the rule is actually
+ * enforced. An address exempt here but not there sees no raised minimum in the
+ * form and is refused at the end, which is worse than not exempting it at all.
+ *
+ * The address matched must be the CONNECTED wallet — the one that owns the KYC
+ * record and signs the agreement request. kasu-backend verifies that signature
+ * before the gate, so an exemption cannot be claimed by asserting someone
+ * else's address; it takes their private key. Never match a "view as" address.
+ *
+ * Comparison is case-insensitive and whitespace-tolerant. Anything that is not
+ * a string is NOT exempt (fail closed), and so is anything when the list is
+ * absent.
+ */
+export function isAuMinimumExempt(address, exemptAddresses) {
+    if (typeof address !== 'string' || !exemptAddresses)
+        return false;
+    const needle = address.trim().toLowerCase();
+    return exemptAddresses.some((a) => a.trim().toLowerCase() === needle);
+}
+const DECIMAL_RE = /^(\d+)?(?:\.(\d*))?$/;
+/**
+ * Truncating, partial-input-tolerant decimal → minor-unit parse.
+ * `'10.'` → `10000000n` · `'1.23456789'` → `1234567n` (truncated at 6dp).
+ * `''` / `'abc'` / negative / null → `null`.
+ *
+ * Tolerant of mid-typing states because it runs on an amount field as the
+ * lender types, and truncating because rounding up would let a position that
+ * is a fraction short read as passing.
+ */
+export function parseMinorUnits(value, decimals) {
+    if (value === null || value === undefined)
+        return null;
+    const raw = typeof value === 'number' ? String(value) : value.trim();
+    if (!raw)
+        return null;
+    const match = DECIMAL_RE.exec(raw);
+    if (!match || (!match[1] && !match[2]))
+        return null;
+    // Both capture groups are optional, so either can be absent at runtime.
+    // A fractional group that matched EMPTY ('10.') is not absent, and the
+    // destructuring defaults leave it alone — only `undefined` takes them.
+    const [, whole = '0', fracDigits = ''] = match;
+    const frac = fracDigits.slice(0, decimals).padEnd(decimals, '0');
+    return BigInt(whole + frac);
+}
+/**
+ * The amount, in WHOLE stable units, an Australian lender still needs in order
+ * to reach the deployment's cumulative minimum. Apply it as the amount field's
+ * floor via `max(trancheMin, auMinimumRemaining(...))`.
+ *
+ * Returns 0 for everyone the rule does not restrict (fail-open), 0 for an
+ * exempt address, and 0 once the lender's existing position already satisfies
+ * the threshold.
+ *
+ * The exemption is tested FIRST and unconditionally: an exempt wallet has no
+ * minimum whatever its country, stable or position says. kasu-backend
+ * deliberately tests country first and the exemption second — the two orders
+ * are not in conflict, both return "no minimum" for the same inputs. There,
+ * the exemption sets a flag that drives a compliance log, so it must not fire
+ * for a lender the rule never engaged for. Here nothing is logged, so
+ * exemption-first is preferred: it makes this function right on its own,
+ * whatever country a caller happens to pass.
+ */
+export function auMinimumRemaining(input) {
+    var _a, _b;
+    if (isAuMinimumExempt(input.address, input.exemptAddresses))
+        return 0;
+    if (!isAustralianKyc(input.country))
+        return 0;
+    const threshold = auThresholdFor(input.stableSymbol);
+    if (threshold === undefined)
+        return 0;
+    const { existingDeposited, decimals } = input;
+    // A table threshold always parses; `?? ZERO` keeps the rule fail-open
+    // rather than asserting, so an unparseable one yields no minimum at all.
+    const thresholdMinor = (_a = parseMinorUnits(threshold, decimals)) !== null && _a !== void 0 ? _a : ZERO;
+    const existingMinor = (_b = parseMinorUnits(existingDeposited, decimals)) !== null && _b !== void 0 ? _b : ZERO;
+    const remaining = thresholdMinor - existingMinor;
+    if (remaining <= ZERO)
+        return 0;
+    const base = BigInt('1' + '0'.repeat(decimals));
+    return Number(remaining / base) + Number(remaining % base) / Number(base);
+}
+//# sourceMappingURL=au-minimum.js.map

package/dist/domain/au-minimum.js.map

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

package/dist/domain/au-minimum.test.js

@@ -0,0 +1,202 @@
+import { AU_ALPHA3, AU_MIN_CUMULATIVE_BY_STABLE, auMinimumRemaining, auThresholdFor, isAuMinimumExempt, isAustralianKyc, parseMinorUnits, } from './au-minimum';
+/**
+ * Ported from kasu-ui
+ * `src/features/lending/lib/au-lending-restriction.test.ts`, minus the two
+ * cases that pin toast copy — those strings stay in the applications.
+ *
+ * What these pin is the arithmetic: integer bigint minor units and a
+ * truncating parse, so no consumer can disagree with another at the
+ * 360,000 / 500,000 boundary.
+ */
+// 6dp on every current deployment (USDC on Base/XDC, AUDD on XDC).
+const DP = 6;
+const n = (v) => BigInt(v);
+describe('isAustralianKyc', () => {
+    it('accepts the alpha-3 code in any casing, with surrounding whitespace', () => {
+        expect(isAustralianKyc('AUS')).toBe(true);
+        expect(isAustralianKyc('aus')).toBe(true);
+        expect(isAustralianKyc(' AUS ')).toBe(true);
+        expect(isAustralianKyc('Aus')).toBe(true);
+    });
+    it('rejects the alpha-2 code — the collapsed KYC field is alpha-3', () => {
+        // Deliberate: a bare 'AU' must NOT restrict. The KYC claim is
+        // normalised to alpha-3 before it ever reaches this rule.
+        expect(isAustralianKyc('AU')).toBe(false);
+    });
+    it('rejects near-misses and absent countries (fail-open)', () => {
+        expect(isAustralianKyc('AUT')).toBe(false);
+        expect(isAustralianKyc('')).toBe(false);
+        expect(isAustralianKyc(undefined)).toBe(false);
+        expect(isAustralianKyc(null)).toBe(false);
+    });
+    it('exports the alpha-3 constant it compares against', () => {
+        expect(AU_ALPHA3).toBe('AUS');
+    });
+});
+describe('auThresholdFor', () => {
+    it('returns the per-stable whole-unit minimum, case-insensitively', () => {
+        expect(auThresholdFor('USDC')).toBe(360000);
+        expect(auThresholdFor('usdc')).toBe(360000);
+        expect(auThresholdFor(' USDC ')).toBe(360000);
+        expect(auThresholdFor('AUDD')).toBe(500000);
+        expect(auThresholdFor('audd')).toBe(500000);
+    });
+    it('fails open for an unlisted stable or a missing symbol', () => {
+        expect(auThresholdFor('DAI')).toBeUndefined();
+        expect(auThresholdFor(undefined)).toBeUndefined();
+        expect(auThresholdFor(null)).toBeUndefined();
+        expect(auThresholdFor('')).toBeUndefined();
+    });
+    it('exposes the table kasu-backend’s minimums must match', () => {
+        expect(AU_MIN_CUMULATIVE_BY_STABLE).toEqual({
+            USDC: 360000,
+            AUDD: 500000,
+        });
+    });
+});
+describe('parseMinorUnits (6dp)', () => {
+    it('parses whole and partial decimal input', () => {
+        expect(parseMinorUnits('0', DP)).toBe(n('0'));
+        expect(parseMinorUnits('1', DP)).toBe(n('1000000'));
+        // Mid-typing states an amount field really produces.
+        expect(parseMinorUnits('10.', DP)).toBe(n('10000000'));
+        expect(parseMinorUnits('.5', DP)).toBe(n('500000'));
+        expect(parseMinorUnits('1.5', DP)).toBe(n('1500000'));
+    });
+    it('TRUNCATES excess precision — a position can never be inflated into passing', () => {
+        expect(parseMinorUnits('1.23456789', DP)).toBe(n('1234567'));
+    });
+    it('returns null for empty, non-numeric, negative and absent input', () => {
+        expect(parseMinorUnits('', DP)).toBeNull();
+        expect(parseMinorUnits('   ', DP)).toBeNull();
+        expect(parseMinorUnits('abc', DP)).toBeNull();
+        expect(parseMinorUnits('-5', DP)).toBeNull();
+        // A lone separator matches the shape but carries no digits.
+        expect(parseMinorUnits('.', DP)).toBeNull();
+        expect(parseMinorUnits(null, DP)).toBeNull();
+        expect(parseMinorUnits(undefined, DP)).toBeNull();
+    });
+    it('accepts numbers as well as strings', () => {
+        expect(parseMinorUnits(360000, DP)).toBe(n('360000000000'));
+        expect(parseMinorUnits(0, DP)).toBe(n('0'));
+    });
+});
+// `address` and `exemptAddresses` are required keys on AuMinimumInput (a
+// refactor must not be able to drop either silently), so the shared fixture
+// supplies the un-exempted defaults and the exemption cases override them.
+const BASE = {
+    stableSymbol: 'USDC',
+    decimals: DP,
+    address: undefined,
+    exemptAddresses: undefined,
+};
+describe('auMinimumRemaining — fail-open cases return 0 (no raised minimum)', () => {
+    it('is 0 when the KYC country is absent', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: undefined, existingDeposited: '0' }))).toBe(0);
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: null, existingDeposited: '0' }))).toBe(0);
+    });
+    it('is 0 for a non-Australian lender', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'USA', existingDeposited: '0' }))).toBe(0);
+    });
+    it('is 0 on a deployment whose stable has no configured threshold', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { stableSymbol: 'DAI', country: 'AUS', existingDeposited: '0' }))).toBe(0);
+    });
+});
+describe('auMinimumRemaining — Australian lender', () => {
+    it('demands the FULL threshold while the position is unknown (strict-until-loaded)', () => {
+        // `undefined` is not a zero position — it is an unread one. Treating
+        // it as 0 keeps the floor at its strictest until the read lands, so
+        // the field never advertises a minimum lower than the backend accepts.
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: undefined }))).toBe(360000);
+    });
+    it('is 0 once the existing position exactly meets the threshold (inclusive)', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: '360000' }))).toBe(0);
+    });
+    it('is 0 once the existing position exceeds the threshold', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: '400000' }))).toBe(0);
+    });
+    it('returns the remainder for a partial position', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: '120000' }))).toBe(240000);
+    });
+    it('keeps sub-unit precision — one minor unit short still demands one minor unit', () => {
+        // 359,999.999999 lent → 0.000001 USDC left to reach 360,000. The
+        // bigint arithmetic must not round that away into a 0 (unrestricted).
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: '359999.999999' }))).toBe(0.000001);
+    });
+    it('accepts a numeric existing position, not just a string', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', existingDeposited: 120000 }))).toBe(240000);
+    });
+    it('uses the 500,000 threshold on AUDD deployments', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { stableSymbol: 'AUDD', country: 'AUS', existingDeposited: 0 }))).toBe(500000);
+    });
+});
+// Deployment configuration the caller supplies — see `isAuMinimumExempt`. The
+// real list is never shipped in this public package; these are stand-ins.
+const EXEMPT_CHECKSUMMED = '0x1111111111111111111111111111111111111111';
+const EXEMPT_LOWER = EXEMPT_CHECKSUMMED.toLowerCase();
+const OTHER_EXEMPT = '0x2222222222222222222222222222222222222222';
+const NOT_EXEMPT = '0x3333333333333333333333333333333333333333';
+const LIST = [EXEMPT_LOWER, OTHER_EXEMPT.toLowerCase()];
+describe('isAuMinimumExempt', () => {
+    it('matches a listed wallet in any casing, with surrounding whitespace', () => {
+        expect(isAuMinimumExempt(EXEMPT_CHECKSUMMED, LIST)).toBe(true);
+        expect(isAuMinimumExempt(EXEMPT_LOWER, LIST)).toBe(true);
+        expect(isAuMinimumExempt(EXEMPT_LOWER.toUpperCase(), LIST)).toBe(true);
+        expect(isAuMinimumExempt(`  ${OTHER_EXEMPT}  `, LIST)).toBe(true);
+    });
+    it('matches a list entry stored in mixed case too', () => {
+        // The rule normalises both sides, so a caller that reads its list
+        // straight out of configuration cannot be caught out by casing.
+        expect(isAuMinimumExempt(EXEMPT_LOWER, [EXEMPT_CHECKSUMMED.toUpperCase()])).toBe(true);
+    });
+    it('fails CLOSED on anything unlisted or not a string', () => {
+        expect(isAuMinimumExempt(NOT_EXEMPT, LIST)).toBe(false);
+        expect(isAuMinimumExempt('', LIST)).toBe(false);
+        expect(isAuMinimumExempt('   ', LIST)).toBe(false);
+        expect(isAuMinimumExempt(undefined, LIST)).toBe(false);
+        expect(isAuMinimumExempt(null, LIST)).toBe(false);
+        // A prefix of, or an extension to, a listed address is another wallet.
+        expect(isAuMinimumExempt(EXEMPT_LOWER.slice(0, -1), LIST)).toBe(false);
+        expect(isAuMinimumExempt(`${EXEMPT_LOWER}00`, LIST)).toBe(false);
+    });
+    it('fails CLOSED when no list was supplied', () => {
+        expect(isAuMinimumExempt(EXEMPT_LOWER, undefined)).toBe(false);
+        expect(isAuMinimumExempt(EXEMPT_LOWER, null)).toBe(false);
+        expect(isAuMinimumExempt(EXEMPT_LOWER, [])).toBe(false);
+    });
+});
+describe('auMinimumRemaining — named-address exemption', () => {
+    it('is 0 for an exempt wallet that would otherwise owe the full threshold', () => {
+        for (const address of [
+            EXEMPT_CHECKSUMMED,
+            EXEMPT_LOWER,
+            OTHER_EXEMPT,
+        ]) {
+            expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', address, exemptAddresses: LIST, existingDeposited: 0 }))).toBe(0);
+        }
+    });
+    it('is 0 on AUDD too, where the threshold is the larger 500,000', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { stableSymbol: 'AUDD', country: 'AUS', address: EXEMPT_LOWER, exemptAddresses: LIST, existingDeposited: 0 }))).toBe(0);
+    });
+    it('overrides an UNKNOWN position — the strict full-threshold case', () => {
+        // `undefined` is what a caller passes while the on-chain read is in
+        // flight, and it normally yields the whole threshold. An exemption
+        // outranks it, so an exempt lender never sees a floor that later drops.
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', address: EXEMPT_LOWER, exemptAddresses: LIST, existingDeposited: undefined }))).toBe(0);
+    });
+    it('leaves a non-exempt Australian on the full threshold', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', address: NOT_EXEMPT, exemptAddresses: LIST, existingDeposited: 0 }))).toBe(360000);
+    });
+    it('treats an absent address, or an absent list, as NOT exempt', () => {
+        // Both keys are required; either VALUE may be absent, and when it is
+        // the rule applies exactly as it did before exemptions existed.
+        for (const address of [undefined, null]) {
+            expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', address, exemptAddresses: LIST, existingDeposited: 0 }))).toBe(360000);
+        }
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'AUS', address: EXEMPT_LOWER, exemptAddresses: undefined, existingDeposited: 0 }))).toBe(360000);
+    });
+    it('is 0 for a non-Australian at an exempt address, as it always was', () => {
+        expect(auMinimumRemaining(Object.assign(Object.assign({}, BASE), { country: 'FRA', address: EXEMPT_LOWER, exemptAddresses: LIST, existingDeposited: 0 }))).toBe(0);
+    });
+});
+//# sourceMappingURL=au-minimum.test.js.map

package/dist/domain/au-minimum.test.js.map

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

package/dist/domain/deposit-bounds.d.ts

@@ -0,0 +1,62 @@
+import { TrancheData } from '../services/DataService/types';
+export declare const MIN_LENDING_AMOUNT_FALLBACK = 500;
+export declare const MAX_LENDING_AMOUNT_FALLBACK = 500000;
+export declare function parseTrancheBound(raw: string | number | null | undefined): number | null;
+export interface DepositBounds {
+    minDeposit: number;
+    maxDeposit: number;
+}
+/**
+ * Min + max lending amount (in whole stable units) for a tranche. The max is
+ * clamped by the tranche's *remaining* capacity: a tranche can fill mid-epoch
+ * while `maximumDeposit` stays at its configured value, so without the clamp
+ * a form would accept an amount the contract will reject. Mirrors
+ * kasu-fe-next's `calculateDepositMinMax` (`trancheMax = min(max, capacity)`).
+ */
+export declare function resolveDepositBounds(tranche: TrancheData | undefined): DepositBounds;
+export interface BoundShortcuts {
+    min: number;
+    max: number;
+    enabled: boolean;
+}
+/**
+ * The values a lend form's clickable Min/Max labels write into the amount
+ * field. Derived from the validated bounds but snapped to whole cents
+ * CONSERVATIVELY — the min rounds UP, the max rounds DOWN — so a shortcut can
+ * never fill an amount the form's own `min ≤ amount ≤ max` check rejects, and
+ * never carries the SDK's float noise into the field (`targetDrawAmount -
+ * pendingDeposits` routinely yields `249999.99999999997`, which would make the
+ * label, the field's 2dp display and the signed request label all disagree).
+ *
+ * `enabled` is false when the snapped range is empty: a tranche at capacity
+ * (max clamps to 0 or to sub-cent dust), a remaining capacity below the
+ * tranche minimum, or a jurisdiction floor above the capacity. Nothing either
+ * shortcut could write would validate, so both render inert.
+ */
+export declare function resolveBoundShortcuts(minDeposit: number, maxDeposit: number): BoundShortcuts;
+/**
+ * True when no amount exists that satisfies both bounds — the minimum sits
+ * ABOVE the maximum, so the range a form would otherwise print ("Min 360,000 ·
+ * Max 25,285") is a contradiction, not an instruction. Happens when a
+ * tranche's remaining capacity falls under its own configured minimum, when it
+ * is at capacity (max 0 / sub-cent dust), or when the AU wholesale cumulative
+ * floor lands above the capacity that is left.
+ *
+ * Defined as the negation of `resolveBoundShortcuts().enabled` on purpose: the
+ * "there is nothing to click" and "there is nothing to type" states must never
+ * be able to disagree.
+ *
+ * This is UX only. The binding minimum is enforced by kasu-backend (403
+ * `AU_WHOLESALE_MINIMUM_NOT_MET`) and by the contract's own bounds; nothing
+ * here may be used to relax either.
+ */
+export declare function isBelowMinimumCapacity(minDeposit: number, maxDeposit: number): boolean;
+/**
+ * Largest whole-cent value ≤ `n`. Float multiplication can round `n * 100` UP
+ * onto an integer (`1.15 * 100 === 114.99999999999999` is the usual direction,
+ * but the other happens too), so the result is re-checked against `n` and
+ * stepped down a cent if it overshot — the contract is "never above `n`".
+ */
+export declare function floorToCents(n: number): number;
+/** Smallest whole-cent value ≥ `n`. Mirror of `floorToCents`: never below `n`. */
+export declare function ceilToCents(n: number): number;