xrpjson 0.1.0

package/dist/fp/factories/loan-broker-cover-clawback.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Functional LoanBrokerCoverClawback factory — frozen-object style.
+ *
+ * Claws back First-Loss Capital from a `LoanBroker` ledger entry. Only the
+ * Issuer of the Loan asset can submit this. Clawback is limited to the
+ * minimum cover required for current loans.
+ *
+ *   import { loanBrokerCoverClawback } from 'xrplt/fp';
+ *   const tx = loanBrokerCoverClawback({ Account, LoanBrokerID, Amount });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Amount: { currency: 'USD', issuer, value: '50' } });
+ *
+ * LoanBrokerCoverClawback has no flags defined by the spec.
+ *
+ * Affected amendments:
+ *   - `LendingProtocol` (base LoanBrokerCoverClawback)
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/loanbrokercoverclawback
+ * @see XLS-66 §3.7 (Transaction: `LoanBrokerCoverClawback`)
+ *      in `~/.mavis/docs.local/xrpl-standards/repo/XLS-0066-lending-protocol/README.md`
+ *
+ * ## Divergences
+ *
+ * The factory enforces five preclaim checks the class API
+ * (`src/transactions/loan-broker-cover-clawback.ts`) skips:
+ *
+ *   1. `LoanBrokerID` must NOT be the all-zeros HASH256 value when present.
+ *      Source: XLS-66 §3.7.3.1 check 2 — "`LoanBrokerID` is specified and is
+ *      zero. (`temINVALID`)"
+ *      The class only validates `isString` + `isHex` + length 64 (i.e.
+ *      `isLedgerEntryId`), which is satisfied by the all-zeros string.
+ *      xrpl.js `validateLoanBrokerCoverClawback` has the same gap.
+ *      (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/loanBrokerCoverClawback.ts`
+ *      lines 53-57.)
+ *
+ *   2. `LoanBrokerID` is required when `Amount` is an MPT, and required
+ *      when `Amount` is an IOU whose `issuer` matches the submitter
+ *      `Account`.
+ *      Source: XLS-66 §3.7.3.1 checks 6 and 7:
+ *        - "`LoanBrokerID` is not specified and `Amount` specifies an MPT.
+ *          (`temINVALID`)"
+ *        - "`LoanBrokerID` is not specified, `Amount` specifies an IOU, and
+ *          `Amount.issuer` is the submitter `Account` or zero. (`temINVALID`)"
+ *      The class does not enforce either cross-field dependency; it only
+ *      requires that at least one of `LoanBrokerID`/`Amount` be present.
+ *      xrpl.js `validateLoanBrokerCoverClawback` also skips these.
+ *      (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/loanBrokerCoverClawback.ts`
+ *      lines 45-67.)
+ *
+ *   3. `Amount.value` must be a well-formed non-negative XRPL Number
+ *      (matches the spec's "legal net amount" requirement of §3.7.3.1
+ *      check 5). The class uses `Number(value)` and only checks
+ *      `Number.isNaN` / `< 0`, which silently accepts malformed input
+ *      like `""`, `"   "`, or `"1.2.3"`. The factory accepts the
+ *      canonical XRPL Number form: decimal strings or scientific
+ *      mantissa (`1.5e3`), and rejects anything else.
+ *      Source: xrpl.org generic Amount spec
+ *      (https://xrpl.org/docs/references/protocol/data-types/basic-data-types#specifying-currency-amounts).
+ *
+ *   4. `Amount` sub-field shape (`currency`/`issuer` for IOU;
+ *      `mpt_issuance_id` for MPT) is validated, mirroring the strict
+ *      policy used by the `vaultClawback` factory. The class only
+ *      delegates to `isIssuedCurrencyAmount` / `isMPTAmount`, which
+ *      verify key presence but not the well-formedness of the values.
+ *      Source: xrpl-dev-portal basic-data-types (currency must be 3 ASCII
+ *      or 40 hex characters; MPT issuance ID is a 192-bit hex string).
+ *
+ *   5. `Account` is validated as a classic or X-address. The class does
+ *      not check `Account` here — this divergence is identical across
+ *      the loan factories and is documented per-factory.
+ *
+ * Note: the factory accepts `Amount.value === '0'` because the spec
+ * explicitly defines zero as the "clawback down to minimum cover" signal
+ * (XLS-66 §3.7.4 state change 2). xrpl.js and the class agree.
+ */
+import type { ClawbackAmount } from '../../types/amounts.js';
+export interface LoanBrokerCoverClawbackProps {
+    /** The unique address of the transaction sender (must be the Loan asset's Issuer). */
+    Account: string;
+    /**
+     * Optional. The ID of the `LoanBroker` ledger entry to claw back from.
+     * 64-char hex. Required if Amount is MPT or Amount is IOU and
+     * `Amount.issuer === Account`.
+     */
+    LoanBrokerID?: string | undefined;
+    /**
+     * Optional First-Loss Capital amount to claw back. IOU or MPT form
+     * (NOT XRP). If `0` or omitted, claws back up to
+     * `LoanBroker.DebtTotal * LoanBroker.CoverRateMinimum`.
+     */
+    Amount?: ClawbackAmount | undefined;
+    /** No flags defined by the spec; permitted for base-tx parity. */
+    Flags?: number | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface LoanBrokerCoverClawback extends Readonly<LoanBrokerCoverClawbackProps> {
+    readonly TransactionType: 'LoanBrokerCoverClawback';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanBrokerCoverClawbackProps>): LoanBrokerCoverClawback;
+}
+export declare function loanBrokerCoverClawback(props: LoanBrokerCoverClawbackProps): LoanBrokerCoverClawback;
+//# sourceMappingURL=loan-broker-cover-clawback.d.ts.map

package/dist/fp/factories/loan-broker-cover-clawback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loan-broker-cover-clawback.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/loan-broker-cover-clawback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+B7D,MAAM,WAAW,4BAA4B;IAC3C,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,uBACf,SAAQ,QAAQ,CAAC,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CACF,SAAS,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAC/C,uBAAuB,CAAC;CAC5B;AAoBD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,uBAAuB,CAuIzB"}

package/dist/fp/factories/loan-broker-cover-clawback.js

@@ -0,0 +1,122 @@
+import { isAccount, isHex, isIssuedCurrencyAmount, isMPTAmount, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// LoanBrokerID is a HASH256 = 32 bytes = 64 hex chars.
+const LOAN_BROKER_ID_LENGTH = 64;
+// All-zeros HASH256 is reserved / malformed per XLS-66 §3.7.3.1 check 2.
+const LOAN_BROKER_ID_ZERO = '0000000000000000000000000000000000000000000000000000000000000000';
+// Currency codes are either 3 ASCII characters or 40 hex characters.
+const CURRENCY_ASCII_LENGTH = 3;
+const CURRENCY_HEX_LENGTH = 40;
+// MPT issuance IDs are 192-bit, hex-encoded (≤ 48 chars).
+// We accept 24..48 to leave slack for future widenings / leading-zero
+// encoders. Empty strings are rejected.
+const MPT_ISSUANCE_ID_MIN = 24;
+const MPT_ISSUANCE_ID_MAX = 48;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Per XLS-66 §3.7.3.1 check 3 (`Amount < 0` rejected, `Amount >= 0`
+ * accepted) and check 5 ("legal net amount"). Accepts the canonical
+ * XRPL Number form: decimal strings or scientific mantissa (`1.5e3`).
+ *
+ * Zero is explicitly allowed per §3.7.4 state change 2 (clawback down
+ * to minimum cover).
+ */
+function isNonNegativeAmountValue(value) {
+    if (typeof value !== 'string')
+        return false;
+    if (!/^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u.test(value))
+        return false;
+    return parseFloat(value) >= 0;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function loanBrokerCoverClawback(props) {
+    // ── Account ── required, must be a valid XRPL classic or X-address.
+    require(props.Account, 'LoanBrokerCoverClawback: Account is required', isAccount);
+    // ── LoanBrokerID ── optional, but if present: 64-char hex AND non-zero.
+    if (props.LoanBrokerID !== undefined) {
+        if (!isString(props.LoanBrokerID) ||
+            !isHex(props.LoanBrokerID) ||
+            props.LoanBrokerID.length !== LOAN_BROKER_ID_LENGTH) {
+            throw new ValidationError('LoanBrokerCoverClawback: LoanBrokerID must be a 64-character hex string');
+        }
+        if (props.LoanBrokerID === LOAN_BROKER_ID_ZERO) {
+            throw new ValidationError('LoanBrokerCoverClawback: LoanBrokerID must not be the all-zeros HASH256 value');
+        }
+    }
+    // ── Amount ── optional, but if present: must be a valid ClawbackAmount
+    // (IOU/MPT, NOT XRP), with well-formed sub-fields and value >= 0.
+    if (props.Amount !== undefined) {
+        if (!isIssuedCurrencyAmount(props.Amount) &&
+            !isMPTAmount(props.Amount)) {
+            throw new ValidationError('LoanBrokerCoverClawback: Amount must be a valid ClawbackAmount (trust line / MPT form, NOT XRP)');
+        }
+        if (isIssuedCurrencyAmount(props.Amount)) {
+            // Currency: 3 ASCII or 40 hex characters.
+            const ccy = props.Amount.currency;
+            if (ccy.length !== CURRENCY_ASCII_LENGTH &&
+                ccy.length !== CURRENCY_HEX_LENGTH) {
+                throw new ValidationError(`LoanBrokerCoverClawback: Amount.currency must be ${CURRENCY_ASCII_LENGTH} ASCII characters or ${CURRENCY_HEX_LENGTH} hex characters (actual: ${ccy.length})`);
+            }
+            if (ccy.length === CURRENCY_HEX_LENGTH && !isHex(ccy)) {
+                throw new ValidationError('LoanBrokerCoverClawback: Amount.currency (40-char form) must be hex');
+            }
+            // Issuer must be a valid XRPL account.
+            if (!isAccount(props.Amount.issuer)) {
+                throw new ValidationError('LoanBrokerCoverClawback: Amount.issuer must be a valid XRPL account address');
+            }
+            // Value: legal non-negative XRPL Number.
+            if (!isNonNegativeAmountValue(props.Amount.value)) {
+                throw new ValidationError('LoanBrokerCoverClawback: Amount.value must be a non-negative numeric string (decimal or scientific mantissa)');
+            }
+        }
+        else {
+            // MPT amount.
+            const mptid = props.Amount.mpt_issuance_id;
+            if (mptid.length < MPT_ISSUANCE_ID_MIN ||
+                mptid.length > MPT_ISSUANCE_ID_MAX ||
+                !isHex(mptid)) {
+                throw new ValidationError(`LoanBrokerCoverClawback: Amount.mpt_issuance_id must be a ${MPT_ISSUANCE_ID_MIN}-${MPT_ISSUANCE_ID_MAX} character hex string`);
+            }
+            if (!isNonNegativeAmountValue(props.Amount.value)) {
+                throw new ValidationError('LoanBrokerCoverClawback: Amount.value must be a non-negative numeric string (decimal or scientific mantissa)');
+            }
+        }
+    }
+    // ── At-least-one rule ── XLS-66 §3.7.3.1 check 1.
+    if (props.LoanBrokerID === undefined && props.Amount === undefined) {
+        throw new ValidationError('LoanBrokerCoverClawback: Either LoanBrokerID or Amount is required');
+    }
+    // ── Cross-field rule: LoanBrokerID missing + MPT Amount ── §3.7.3.1 check 6.
+    if (props.LoanBrokerID === undefined && props.Amount !== undefined) {
+        if (isMPTAmount(props.Amount)) {
+            throw new ValidationError('LoanBrokerCoverClawback: LoanBrokerID is required when Amount is an MPT');
+        }
+        // ── Cross-field rule: LoanBrokerID missing + IOU issuer == Account ── §3.7.3.1 check 7.
+        if (isIssuedCurrencyAmount(props.Amount) &&
+            props.Amount.issuer === props.Account) {
+            throw new ValidationError('LoanBrokerCoverClawback: LoanBrokerID is required when Amount is an IOU whose issuer is the submitter Account');
+        }
+    }
+    return buildFrozenTx('LoanBrokerCoverClawback', props, {
+        validate() {
+            // Validated at construction.
+        },
+        toJSON() {
+            const json = {};
+            for (const k of Object.keys(this)) {
+                if (k === 'validate' || k === 'toJSON' || k === 'with')
+                    continue;
+                const v = this[k];
+                if (v !== undefined)
+                    json[k] = v;
+            }
+            return json;
+        },
+        with(overrides) {
+            return loanBrokerCoverClawback(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=loan-broker-cover-clawback.js.map

package/dist/fp/factories/loan-broker-cover-clawback.js.map

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

package/dist/fp/factories/loan-broker-cover-deposit.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Functional LoanBrokerCoverDeposit factory — frozen-object style.
+ *
+ * The Loan Broker owner deposits First-Loss Capital into a `LoanBroker`
+ * ledger entry to back the vault against loan defaults. Validation happens
+ * at construction; there is no way to construct an invalid tx.
+ *
+ *   import { loanBrokerCoverDeposit } from 'xrplt/fp';
+ *   const tx = loanBrokerCoverDeposit({ Account, LoanBrokerID, Amount });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Amount: { currency: 'USD', issuer, value: '1500' } });
+ *
+ * LoanBrokerCoverDeposit has no flags defined by the spec.
+ *
+ * Affected amendments:
+ *   - `LendingProtocol` (base LoanBrokerCoverDeposit)
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/loanbrokercoverdeposit
+ * @see https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0066-lending-protocol
+ *
+ * ## Divergences
+ *
+ * The factory enforces two preclaim checks that the class API
+ * (`src/transactions/loan-broker-cover-deposit.ts`) skips:
+ *
+ *   1. `LoanBrokerID` must not be the all-zeros HASH256 value.
+ *      Source: XLS-66 §3.5.3.1 check 1 — "`LoanBrokerID` is zero (`temINVALID`)"
+ *      (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0066-lending-protocol/README.md`
+ *      line 755).
+ *      xrpl.js `validateLoanBrokerCoverDeposit` only checks `isLedgerEntryId`,
+ *      which is satisfied by the all-zeros string
+ *      (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/loanBrokerCoverDeposit.ts`
+ *      lines 46-50).
+ *
+ *   2. `Amount` must be strictly positive (non-zero, non-negative) in
+ *      all three forms (XRP drops string, `IssuedCurrencyAmount.value`,
+ *      `MPTAmount.value`).
+ *      Source: XLS-66 §3.5.3.1 check 2 — "`Amount <= 0` (`temBAD_AMOUNT`)"
+ *      (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0066-lending-protocol/README.md`
+ *      line 756).
+ *      xrpl.js `validateLoanBrokerCoverDeposit` only checks `isAmount`, which
+ *      accepts any numeric string regardless of sign; the local
+ *      `validation/helpers.isAmount` has the same gap.
+ */
+import type { Amount, MPTAmount } from '../../types/amounts.js';
+export interface LoanBrokerCoverDepositProps {
+    /** The unique address of the transaction sender (must be `LoanBroker.Owner`). */
+    Account: string;
+    /** The ID of the `LoanBroker` ledger entry to deposit First-Loss Capital into. 64-char hex. */
+    LoanBrokerID: string;
+    /** First-Loss Capital amount to deposit (XRP / trust line / MPT). */
+    Amount: Amount | MPTAmount;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface LoanBrokerCoverDeposit extends Readonly<LoanBrokerCoverDepositProps> {
+    readonly TransactionType: 'LoanBrokerCoverDeposit';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanBrokerCoverDepositProps>): LoanBrokerCoverDeposit;
+}
+export declare function loanBrokerCoverDeposit(props: LoanBrokerCoverDepositProps): LoanBrokerCoverDeposit;
+//# sourceMappingURL=loan-broker-cover-deposit.d.ts.map

package/dist/fp/factories/loan-broker-cover-deposit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loan-broker-cover-deposit.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/loan-broker-cover-deposit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAehE,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,sBACf,SAAQ,QAAQ,CAAC,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAAG,sBAAsB,CAAC;CAC/E;AAoCD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CA4DxB"}

package/dist/fp/factories/loan-broker-cover-deposit.js

@@ -0,0 +1,81 @@
+import { isAccount, isAmount, isHex, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// LoanBrokerID is a HASH256 = 32 bytes = 64 hex chars.
+const LOAN_BROKER_ID_LENGTH = 64;
+// All-zeros HASH256 is reserved / malformed per spec.
+const LOAN_BROKER_ID_ZERO = '0000000000000000000000000000000000000000000000000000000000000000';
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Per XLS-66 §3.5.3.1 check 2: "`Amount <= 0` (`temBAD_AMOUNT`)".
+ * Validates the sign of an Amount in all three accepted forms.
+ *
+ *   - XRP form: a decimal-string of drops (e.g. "1000000").
+ *   - IssuedCurrency form: object with a `value` sub-string.
+ *   - MPT form: object with a `value` sub-string.
+ *
+ * Accepts the canonical scientific mantissa form (`1.5e3`) so this
+ * stays compatible with the XRPL serialization layer. Negative or
+ * zero mantissas are rejected.
+ */
+function isPositiveAmount(amount) {
+    // XRP drops — a decimal or scientific-mantissa string.
+    if (typeof amount === 'string') {
+        if (!/^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u.test(amount)) {
+            return false;
+        }
+        return parseFloat(amount) > 0;
+    }
+    // Object form (IssuedCurrency or MPT).
+    if (typeof amount !== 'object' || amount === null)
+        return false;
+    const value = amount.value;
+    if (typeof value !== 'string')
+        return false;
+    if (!/^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u.test(value)) {
+        return false;
+    }
+    return parseFloat(value) > 0;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function loanBrokerCoverDeposit(props) {
+    // ── Account ── required, must be a valid XRPL classic address.
+    require(props.Account, 'LoanBrokerCoverDeposit: Account is required', isAccount);
+    // ── LoanBrokerID ── required, 64-char hex AND non-zero.
+    if (!isString(props.LoanBrokerID) ||
+        !isHex(props.LoanBrokerID) ||
+        props.LoanBrokerID.length !== LOAN_BROKER_ID_LENGTH) {
+        throw new ValidationError('LoanBrokerCoverDeposit: LoanBrokerID must be a 64-character hex string');
+    }
+    if (props.LoanBrokerID === LOAN_BROKER_ID_ZERO) {
+        throw new ValidationError('LoanBrokerCoverDeposit: LoanBrokerID must not be the all-zeros HASH256 value');
+    }
+    // ── Amount ── required, must be a valid Amount AND strictly positive.
+    if (!isAmount(props.Amount)) {
+        throw new ValidationError('LoanBrokerCoverDeposit: Amount must be a valid Amount (XRP / trust line / MPT form)');
+    }
+    if (!isPositiveAmount(props.Amount)) {
+        throw new ValidationError('LoanBrokerCoverDeposit: Amount must be strictly positive (non-zero, non-negative)');
+    }
+    return buildFrozenTx('LoanBrokerCoverDeposit', props, {
+        validate() {
+            // Validated at construction.
+        },
+        toJSON() {
+            const json = {};
+            for (const k of Object.keys(this)) {
+                if (k === 'validate' || k === 'toJSON' || k === 'with')
+                    continue;
+                const v = this[k];
+                if (v !== undefined)
+                    json[k] = v;
+            }
+            return json;
+        },
+        with(overrides) {
+            return loanBrokerCoverDeposit(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=loan-broker-cover-deposit.js.map

package/dist/fp/factories/loan-broker-cover-deposit.js.map

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

package/dist/fp/factories/loan-broker-cover-withdraw.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Functional LoanBrokerCoverWithdraw factory — frozen-object style.
+ *
+ * Withdraws First-Loss Capital from a `LoanBroker` ledger entry. Validation
+ * happens at construction; there is no way to construct an invalid tx.
+ *
+ *   import { loanBrokerCoverWithdraw } from 'xrplt/fp';
+ *   const tx = loanBrokerCoverWithdraw({
+ *     Account: 'rMX...',          // LoanBroker.Owner
+ *     LoanBrokerID: 'A947...614',
+ *     Amount: '5000000',
+ *     Destination: 'rPT1...',     // optional
+ *     DestinationTag: 42,         // optional
+ *     CredentialIDs: ['A7B7...'], // optional
+ *   });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Destination: 'rXY...' });
+ *
+ * Affected amendments:
+ *   - `LendingProtocolV1_1` (base LoanBrokerCoverWithdraw)
+ *   - `Credentials` (CredentialIDs for permissioned-domain authorization)
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/loanbrokercoverwithdraw
+ * @see https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0066-lending-protocol
+ *
+ * ## Divergences
+ *
+ * Compared with `src/transactions/loan-broker-cover-withdraw.ts`, this
+ * factory enforces preclaim guards the class API skips:
+ *
+ * 1. **`LoanBrokerID` must not be the all-zeros HASH256 value.**
+ *    Source: XLS-66 §3.6.3.1 check 1 — "`LoanBrokerID` is zero
+ *    (`temINVALID`)" (`~/.mavis/docs.local/xrpl-standards/repo/
+ *    XLS-0066-lending-protocol/README.md` line 827). The class only
+ *    checks `isString && isHex && length === 64`, which the all-zeros
+ *    string satisfies. xrpl.js `validateLoanBrokerCoverWithdraw` only
+ *    checks `isLedgerEntryId`, which also accepts the all-zeros string
+ *    (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/
+ *    transactions/loanBrokerCoverWithdraw.ts` lines 77–81).
+ *
+ * 2. **`Amount` must be strictly positive (non-zero, non-negative).**
+ *    Source: XLS-66 §3.6.3.1 check 2 — "`Amount <= 0` (`temBAD_AMOUNT`)"
+ *    (line 828). The class only delegates to `isAmount`, which accepts
+ *    any numeric string including `'0'` and `'-1'`. The local helper
+ *    `validation/helpers.isAmount` has the same gap. xrpl.js `isAmount`
+ *    likewise does not check sign. The factory adds an
+ *    `isPositiveAmount` helper covering all three Amount forms
+ *    (XRP drops, IssuedCurrency `value`, MPT `value`).
+ *
+ * 3. **`Destination` must not be the all-zeros AccountID.**
+ *    Source: XLS-66 §3.6.3.1 check 3 — "`Destination` is specified and is
+ *    zero (`temMALFORMED`)" (line 829). The class calls `isAccount` on
+ *    `Destination`, which would reject the all-zeros 40-char hex string
+ *    because it lacks the `r…` / `X…` prefix. The factory relies on the
+ *    same implicit gate but documents it as a divergence so the behaviour
+ *    is auditable.
+ *
+ * 4. **`CredentialIDs` must have length in [1, MAX_AUTHORIZED_CREDENTIALS].**
+ *    Source: xrpl.js `MAX_AUTHORIZED_CREDENTIALS = 8` for non-DomainSet
+ *    transactions (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/
+ *    models/transactions/common.ts:28`), and `validateCredentialsList`
+ *    rejects both empty arrays and arrays that exceed `maxCredentials`
+ *    (`loanBrokerCoverWithdraw.ts` lines 70–75; `common.ts:1120-1128`).
+ *    The class only validates the shape of each entry, not the array
+ *    length bounds.
+ */
+import type { Amount, MPTAmount } from '../../types/amounts.js';
+export interface LoanBrokerCoverWithdrawProps {
+    /** The unique address of the transaction sender (`LoanBroker.Owner`). */
+    Account: string;
+    /** The ID of the `LoanBroker` to withdraw First-Loss Capital from. 64-char hex. */
+    LoanBrokerID: string;
+    /** First-Loss Capital amount to withdraw. XRP drops / trust line / MPT. */
+    Amount: Amount | MPTAmount;
+    /** Optional destination account. Must be able to receive the asset. */
+    Destination?: string | undefined;
+    /** Optional destination tag. UINT32. */
+    DestinationTag?: number | undefined;
+    /**
+     * Optional array of credential IDs authorizing the withdrawal when the
+     * destination is gated by a permissioned domain (Credentials amendment).
+     */
+    CredentialIDs?: string[] | undefined;
+    /** LoanBrokerCoverWithdraw has no defined flags; permitted for base-tx parity. */
+    Flags?: number | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface LoanBrokerCoverWithdraw extends Readonly<LoanBrokerCoverWithdrawProps> {
+    readonly TransactionType: 'LoanBrokerCoverWithdraw';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanBrokerCoverWithdrawProps>): LoanBrokerCoverWithdraw;
+}
+export declare function loanBrokerCoverWithdraw(props: LoanBrokerCoverWithdrawProps): LoanBrokerCoverWithdraw;
+//# sourceMappingURL=loan-broker-cover-withdraw.d.ts.map

package/dist/fp/factories/loan-broker-cover-withdraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loan-broker-cover-withdraw.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/loan-broker-cover-withdraw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AA6BhE,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,uBACf,SAAQ,QAAQ,CAAC,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CACF,SAAS,EAAE,OAAO,CAAC,4BAA4B,CAAC,GAC/C,uBAAuB,CAAC;CAC5B;AAkCD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,4BAA4B,GAClC,uBAAuB,CAiHzB"}

package/dist/fp/factories/loan-broker-cover-withdraw.js

@@ -0,0 +1,116 @@
+import { isAccount, isAmount, isArray, isHex, isNumber, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// HASH256 in hex is 64 characters. (XLS-66 §3.6.1: LoanBrokerID is HASH256.)
+const HASH256_HEX_LENGTH = 64;
+// All-zeros HASH256 is reserved / malformed per spec.
+const LOAN_BROKER_ID_ZERO = '0000000000000000000000000000000000000000000000000000000000000000';
+// Credential IDs are 64-char hex (same as ledger entry IDs / HASH256).
+const CREDENTIAL_ID_LENGTH = 64;
+// xrpl.js caps non-DomainSet credential arrays at 8 entries.
+const MAX_CREDENTIAL_IDS = 8;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Per XLS-66 §3.6.3.1 check 2: "`Amount <= 0` (`temBAD_AMOUNT`)".
+ * Validates the sign of an Amount in all three accepted forms.
+ *
+ *   - XRP form: a decimal-string of drops (e.g. "1000000").
+ *   - IssuedCurrency form: object with a `value` sub-string.
+ *   - MPT form: object with a `value` sub-string.
+ *
+ * Accepts the canonical scientific mantissa form (`1.5e3`) so this stays
+ * compatible with the XRPL serialization layer. Negative or zero
+ * mantissas are rejected.
+ */
+function isPositiveAmount(amount) {
+    if (typeof amount === 'string') {
+        if (!/^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u.test(amount)) {
+            return false;
+        }
+        return parseFloat(amount) > 0;
+    }
+    if (typeof amount !== 'object' || amount === null)
+        return false;
+    const value = amount.value;
+    if (typeof value !== 'string')
+        return false;
+    if (!/^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/u.test(value)) {
+        return false;
+    }
+    return parseFloat(value) > 0;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function loanBrokerCoverWithdraw(props) {
+    // ── Account ── required, must be a valid XRPL classic / X-address.
+    require(props.Account, 'LoanBrokerCoverWithdraw: Account is required', isAccount);
+    // ── LoanBrokerID ── required, 64-char hex (HASH256) AND non-zero.
+    if (!isString(props.LoanBrokerID) ||
+        !isHex(props.LoanBrokerID) ||
+        props.LoanBrokerID.length !== HASH256_HEX_LENGTH) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: LoanBrokerID must be a 64-character hex string (HASH256)');
+    }
+    if (props.LoanBrokerID === LOAN_BROKER_ID_ZERO) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: LoanBrokerID must not be the all-zeros HASH256 value');
+    }
+    // ── Amount ── required, must be a valid Amount AND strictly positive.
+    if (!isAmount(props.Amount)) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: Amount must be a valid Amount (XRP / trust line / MPT form)');
+    }
+    if (!isPositiveAmount(props.Amount)) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: Amount must be strictly positive (non-zero, non-negative)');
+    }
+    // ── Destination ── optional, but if provided must be a valid XRPL
+    //    account. The XLS-66 §3.6.3.1 check 3 "Destination is zero" case is
+    //    covered implicitly: the all-zeros 40-char hex string fails
+    //    `isAccount`, which requires a classic `r…` or X-address prefix.
+    if (props.Destination !== undefined && !isAccount(props.Destination)) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: Destination must be a valid XRPL account address');
+    }
+    // ── DestinationTag ── optional, must be a number if present.
+    if (props.DestinationTag !== undefined && !isNumber(props.DestinationTag)) {
+        throw new ValidationError('LoanBrokerCoverWithdraw: DestinationTag must be a number');
+    }
+    // ── CredentialIDs ── optional array, but bounds + entry-shape enforced
+    //    when present. Per xrpl.js: length in [1, MAX_AUTHORIZED_CREDENTIALS];
+    //    each entry is a 64-char hex string.
+    if (props.CredentialIDs !== undefined) {
+        if (!isArray(props.CredentialIDs)) {
+            throw new ValidationError('LoanBrokerCoverWithdraw: CredentialIDs must be an array of credential ID strings');
+        }
+        if (props.CredentialIDs.length === 0) {
+            throw new ValidationError('LoanBrokerCoverWithdraw: CredentialIDs must not be an empty array');
+        }
+        if (props.CredentialIDs.length > MAX_CREDENTIAL_IDS) {
+            throw new ValidationError(`LoanBrokerCoverWithdraw: CredentialIDs length cannot exceed ${MAX_CREDENTIAL_IDS} elements (actual: ${props.CredentialIDs.length})`);
+        }
+        for (let i = 0; i < props.CredentialIDs.length; i++) {
+            const cid = props.CredentialIDs[i];
+            if (!isString(cid) ||
+                !isHex(cid) ||
+                cid.length !== CREDENTIAL_ID_LENGTH) {
+                throw new ValidationError(`LoanBrokerCoverWithdraw: CredentialIDs[${i}] must be a ${CREDENTIAL_ID_LENGTH}-character hex string`);
+            }
+        }
+    }
+    return buildFrozenTx('LoanBrokerCoverWithdraw', props, {
+        validate() {
+            // Validated at construction.
+        },
+        toJSON() {
+            const json = {};
+            for (const k of Object.keys(this)) {
+                if (k === 'validate' || k === 'toJSON' || k === 'with')
+                    continue;
+                const v = this[k];
+                if (v !== undefined)
+                    json[k] = v;
+            }
+            return json;
+        },
+        with(overrides) {
+            return loanBrokerCoverWithdraw(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=loan-broker-cover-withdraw.js.map

package/dist/fp/factories/loan-broker-cover-withdraw.js.map

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

package/dist/fp/factories/loan-broker-delete.d.ts

@@ -0,0 +1,20 @@
+export interface LoanBrokerDeleteProps {
+    /** The unique address of the transaction sender (must be `LoanBroker.Owner`). */
+    Account: string;
+    /** The ID of the `LoanBroker` ledger entry to delete. 64-char hex, non-zero. */
+    LoanBrokerID: string;
+    /** Bit-flags for this transaction. The spec defines none — must be 0. */
+    Flags?: number | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface LoanBrokerDelete extends Readonly<LoanBrokerDeleteProps> {
+    readonly TransactionType: 'LoanBrokerDelete';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanBrokerDeleteProps>): LoanBrokerDelete;
+}
+export declare function loanBrokerDelete(props: LoanBrokerDeleteProps): LoanBrokerDelete;
+//# sourceMappingURL=loan-broker-delete.d.ts.map