xrpjson 0.1.0

package/dist/fp/factories/loan-pay.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Functional LoanPay factory — frozen-object style.
+ *
+ * The Borrower submits a `LoanPay` to make a payment on a Loan. Validation
+ * happens at construction; there is no way to construct an invalid tx.
+ *
+ *   import { loanPay } from 'xrplt/fp';
+ *   const tx = loanPay({ Account, LoanID, Amount: '1000000' });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Flags: 0x00010000 });
+ *
+ * Three mutually-exclusive payment-type flags (at most one per tx):
+ *   - `tfLoanOverpayment` (0x00010000) — excess payment treated as overpayment
+ *   - `tfLoanFullPayment` (0x00020000) — early full repayment
+ *   - `tfLoanLatePayment` (0x00040000) — late loan payment
+ *
+ * Affected amendments:
+ *   - `LendingProtocol` (base LoanPay)
+ *   - `LendingProtocolV1_1` (LendingProtocolV1_1-specific changes;
+ *     per XLS-66.2 §3.2, the late-payment boundary check uses an
+ *     exclusive `currentTime > NextPaymentDueDate` comparison —
+ *     not locally checkable here.)
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/loanpay
+ * @see https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0066-lending-protocol
+ *
+ * ## Divergences
+ * The factory enforces three preclaim checks that the class API
+ * (`src/transactions/loan-pay.ts`) skips:
+ *
+ *   1. `LoanID` must not be the all-zeros HASH256 value.
+ *      Source: XLS-66 §3.11.4.1 check 1 — "`LoanID` is zero (`temINVALID`)".
+ *      xrpl.js `validateLoanPay` only checks `isLedgerEntryId(tx.LoanID)`,
+ *      which is satisfied by the all-zeros string.
+ *
+ *   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.11.4.1 check 2 — "`Amount <= 0` (`temBAD_AMOUNT`)".
+ *      xrpl.js `isAmount` accepts any numeric string and does not check
+ *      the sign of the `value` sub-field of object amounts.
+ *
+ *   3. Payment-type flag exclusivity is also enforced when `Flags` is
+ *      provided as an object (`LoanPayFlagsInterface`).
+ *      Source: xrpl.js `validateLoanPay` (object branch).
+ *      The class API only checks numeric `Flags` and silently accepts
+ *      `{ tfLoanOverpayment: true, tfLoanFullPayment: true }`.
+ */
+import type { Amount, MPTAmount } from '../../types/amounts.js';
+import type { LoanPayFlagsInterface } from '../../types/flags.js';
+export interface LoanPayProps {
+    /** The unique address of the transaction sender (the Borrower). */
+    Account: string;
+    /** The ID of the `Loan` ledger entry to repay. 64-char hex. */
+    LoanID: string;
+    /** Amount of funds to pay (XRP / trust line / MPT). */
+    Amount: Amount | MPTAmount;
+    /** Bit-flags for this transaction. Numeric or boolean map. */
+    Flags?: number | LoanPayFlagsInterface | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface LoanPay extends Readonly<LoanPayProps> {
+    readonly TransactionType: 'LoanPay';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanPayProps>): LoanPay;
+}
+export declare function loanPay(props: LoanPayProps): LoanPay;
+//# sourceMappingURL=loan-pay.d.ts.map

package/dist/fp/factories/loan-pay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loan-pay.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/loan-pay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAyBlE,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CAAC,YAAY,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;CACjD;AAoCD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAsFpD"}

package/dist/fp/factories/loan-pay.js

@@ -0,0 +1,115 @@
+import { isAccount, isAmount, isFlagEnabled, isHex, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+const TF_LOAN_OVERPAYMENT = 0x00010000;
+const TF_LOAN_FULL_PAYMENT = 0x00020000;
+const TF_LOAN_LATE_PAYMENT = 0x00040000;
+// LoanID is a HASH256 = 32 bytes = 64 hex chars.
+const LOAN_ID_LENGTH = 64;
+// All-zeros HASH256 is reserved / malformed per spec.
+const LOAN_ID_ZERO = '0000000000000000000000000000000000000000000000000000000000000000';
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Per XLS-66 §3.11.4.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 loanPay(props) {
+    // ── Account ── required, must be a valid XRPL classic address.
+    require(props.Account, 'LoanPay: Account is required', isAccount);
+    // ── LoanID ── required, 64-char hex AND non-zero.
+    if (!isString(props.LoanID) ||
+        !isHex(props.LoanID) ||
+        props.LoanID.length !== LOAN_ID_LENGTH) {
+        throw new ValidationError('LoanPay: LoanID must be a 64-character hex string');
+    }
+    if (props.LoanID === LOAN_ID_ZERO) {
+        throw new ValidationError('LoanPay: LoanID 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('LoanPay: Amount must be a valid Amount (XRP / trust line / MPT form)');
+    }
+    if (!isPositiveAmount(props.Amount)) {
+        throw new ValidationError('LoanPay: Amount must be strictly positive (non-zero, non-negative)');
+    }
+    // ── Flags ── at most one of the 3 payment-type flags.
+    if (props.Flags !== undefined) {
+        if (typeof props.Flags === 'number') {
+            const set = [];
+            if (isFlagEnabled(props.Flags, TF_LOAN_OVERPAYMENT))
+                set.push('tfLoanOverpayment');
+            if (isFlagEnabled(props.Flags, TF_LOAN_FULL_PAYMENT))
+                set.push('tfLoanFullPayment');
+            if (isFlagEnabled(props.Flags, TF_LOAN_LATE_PAYMENT))
+                set.push('tfLoanLatePayment');
+            if (set.length > 1) {
+                throw new ValidationError(`LoanPay: Only one of tfLoanLatePayment, tfLoanFullPayment, or tfLoanOverpayment flags can be set (got: ${set.join(', ')})`);
+            }
+        }
+        else if (typeof props.Flags === 'object' && props.Flags !== null) {
+            const f = props.Flags;
+            const set = [];
+            if (f.tfLoanOverpayment === true)
+                set.push('tfLoanOverpayment');
+            if (f.tfLoanFullPayment === true)
+                set.push('tfLoanFullPayment');
+            if (f.tfLoanLatePayment === true)
+                set.push('tfLoanLatePayment');
+            if (set.length > 1) {
+                throw new ValidationError(`LoanPay: Only one of tfLoanLatePayment, tfLoanFullPayment, or tfLoanOverpayment flags can be set (got: ${set.join(', ')})`);
+            }
+        }
+        else {
+            throw new ValidationError('LoanPay: Flags must be a number or LoanPayFlagsInterface object');
+        }
+    }
+    return buildFrozenTx('LoanPay', 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 loanPay(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=loan-pay.js.map

package/dist/fp/factories/loan-pay.js.map

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

package/dist/fp/factories/loan-set.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Functional LoanSet factory — frozen-object style.
+ *
+ * Creates a new Loan ledger entry between a Loan Broker and a Borrower.
+ * The class-based equivalent requires a separate `.validate()` call
+ * after construction; this factory validates at construction so an
+ * invalid tx can never exist.
+ *
+ *   import { loanSet } from 'xrplt/fp';
+ *   const tx = loanSet({ Account, LoanBrokerID, PrincipalRequested });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ InterestRate: 250 });
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/loanset
+ */
+import type { CounterpartySignature } from '../../types/common.js';
+import type { LoanSetFlagsInterface } from '../../types/flags.js';
+export interface LoanSetProps {
+    /** The unique address of the transaction sender. */
+    Account: string;
+    /** The ID of the `LoanBroker` ledger entry. 64-char hex. */
+    LoanBrokerID: string;
+    /** Principal loan amount requested by the Borrower (XRPLNumber). */
+    PrincipalRequested: string;
+    /** Counterparty of the loan (the Borrower when sender is Loan Broker). */
+    Counterparty?: string | undefined;
+    /** Counterparty's signature (added by the second signer). */
+    CounterpartySignature?: CounterpartySignature | undefined;
+    /** Arbitrary metadata in hex format, 1–512 characters. */
+    Data?: string | undefined;
+    /** Nominal fee paid to LoanBroker.Owner at loan creation (XRPLNumber). */
+    LoanOriginationFee?: string | undefined;
+    /** Nominal fee paid with every loan payment (XRPLNumber). */
+    LoanServiceFee?: string | undefined;
+    /** Nominal fee for late payments (XRPLNumber). */
+    LatePaymentFee?: string | undefined;
+    /** Nominal fee for early full repayment (XRPLNumber). */
+    ClosePaymentFee?: string | undefined;
+    /** Overpayment fee in 1/10 bp units, 0–100000 (0%–100%). */
+    OverpaymentFee?: number | undefined;
+    /** Annualized interest rate in 1/10 bp units, 0–100000 (0%–100%). */
+    InterestRate?: number | undefined;
+    /** Premium for late payments, 1/10 bp units, 0–100000. */
+    LateInterestRate?: number | undefined;
+    /** Early-repayment fee rate, 1/10 bp units, 0–100000. */
+    CloseInterestRate?: number | undefined;
+    /** Interest rate on overpayments, 1/10 bp units, 0–100000. */
+    OverpaymentInterestRate?: number | undefined;
+    /** Total number of payments to be made against the loan. */
+    PaymentTotal?: number | undefined;
+    /** Number of seconds between loan payments (≥ 60). */
+    PaymentInterval?: number | undefined;
+    /** Seconds after payment due date when loan can be defaulted (≤ PaymentInterval). */
+    GracePeriod?: number | undefined;
+    /** Bit-flags for this transaction. */
+    Flags?: number | LoanSetFlagsInterface | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface LoanSet extends Readonly<LoanSetProps> {
+    readonly TransactionType: 'LoanSet';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<LoanSetProps>): LoanSet;
+}
+export declare function loanSet(props: LoanSetProps): LoanSet;
+//# sourceMappingURL=loan-set.d.ts.map

package/dist/fp/factories/loan-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loan-set.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/loan-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAuBlE,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC1D,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,8DAA8D;IAC9D,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CAAC,YAAY,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;CACjD;AAmBD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAsHpD"}

package/dist/fp/factories/loan-set.js

@@ -0,0 +1,102 @@
+import { isAccount, isHex, isNumber, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// All fees/rates are in units of 1/10 basis point (0–100000 = 0%–100%).
+const MAX_RATE_1_10BP = 100_000;
+// Minimum allowed PaymentInterval (seconds) — spec requires >= 60s.
+const MIN_PAYMENT_INTERVAL_SECONDS = 60;
+// Maximum Data field length in **characters** (hex-encoded).
+const MAX_DATA_LENGTH_CHARS = 512;
+// LoanBrokerID is a 64-char hex ledger entry ID.
+const LOAN_BROKER_ID_LENGTH = 64;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Rate/fee values must be integers within the 1/10 bp range.
+ * Shared by all 5 rate fields (OverpaymentFee, InterestRate, etc.).
+ */
+function rateOutOfRange(value) {
+    return (!isNumber(value) ||
+        !Number.isInteger(value) ||
+        value < 0 ||
+        value > MAX_RATE_1_10BP);
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function loanSet(props) {
+    // ── Account ── required, must be a valid XRPL classic address.
+    require(props.Account, 'LoanSet: Account is required', isAccount);
+    // ── LoanBrokerID ── required, 64-char hex.
+    if (!isString(props.LoanBrokerID) ||
+        !isHex(props.LoanBrokerID) ||
+        props.LoanBrokerID.length !== LOAN_BROKER_ID_LENGTH) {
+        throw new ValidationError('LoanSet: LoanBrokerID must be a 64-character hex string');
+    }
+    // ── PrincipalRequested ── required, non-negative base-10 integer string.
+    if (!isString(props.PrincipalRequested) ||
+        !/^[0-9]+$/u.test(props.PrincipalRequested)) {
+        throw new ValidationError('LoanSet: PrincipalRequested must be a non-negative base-10 integer string');
+    }
+    // ── Counterparty ── valid XRPL account if present.
+    if (props.Counterparty !== undefined && !isAccount(props.Counterparty)) {
+        throw new ValidationError('LoanSet: Counterparty must be a valid XRPL account address');
+    }
+    // ── Data ── hex, 1–512 characters.
+    if (props.Data !== undefined) {
+        if (!isString(props.Data) || !isHex(props.Data)) {
+            throw new ValidationError('LoanSet: Data must be a valid non-empty hex string');
+        }
+        if (props.Data.length === 0 || props.Data.length > MAX_DATA_LENGTH_CHARS) {
+            throw new ValidationError(`LoanSet: Data must be 1 to ${MAX_DATA_LENGTH_CHARS} hex characters (actual: ${props.Data.length})`);
+        }
+    }
+    // ── Rate / fee ranges (all 1/10 bp units, 0–100000).
+    if (props.OverpaymentFee !== undefined && rateOutOfRange(props.OverpaymentFee)) {
+        throw new ValidationError(`LoanSet: OverpaymentFee must be between 0 and ${MAX_RATE_1_10BP} inclusive`);
+    }
+    if (props.InterestRate !== undefined && rateOutOfRange(props.InterestRate)) {
+        throw new ValidationError(`LoanSet: InterestRate must be between 0 and ${MAX_RATE_1_10BP} inclusive`);
+    }
+    if (props.LateInterestRate !== undefined && rateOutOfRange(props.LateInterestRate)) {
+        throw new ValidationError(`LoanSet: LateInterestRate must be between 0 and ${MAX_RATE_1_10BP} inclusive`);
+    }
+    if (props.CloseInterestRate !== undefined && rateOutOfRange(props.CloseInterestRate)) {
+        throw new ValidationError(`LoanSet: CloseInterestRate must be between 0 and ${MAX_RATE_1_10BP} inclusive`);
+    }
+    if (props.OverpaymentInterestRate !== undefined && rateOutOfRange(props.OverpaymentInterestRate)) {
+        throw new ValidationError(`LoanSet: OverpaymentInterestRate must be between 0 and ${MAX_RATE_1_10BP} inclusive`);
+    }
+    // ── PaymentInterval ── ≥ 60 seconds.
+    if (props.PaymentInterval !== undefined) {
+        if (!isNumber(props.PaymentInterval) ||
+            !Number.isInteger(props.PaymentInterval) ||
+            props.PaymentInterval < MIN_PAYMENT_INTERVAL_SECONDS) {
+            throw new ValidationError(`LoanSet: PaymentInterval must be an integer ≥ ${MIN_PAYMENT_INTERVAL_SECONDS} seconds`);
+        }
+        // GracePeriod ≤ PaymentInterval when both present.
+        if (props.GracePeriod !== undefined &&
+            isNumber(props.GracePeriod) &&
+            props.GracePeriod > props.PaymentInterval) {
+            throw new ValidationError('LoanSet: GracePeriod must not be greater than PaymentInterval');
+        }
+    }
+    return buildFrozenTx('LoanSet', 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 loanSet(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=loan-set.js.map

package/dist/fp/factories/loan-set.js.map

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

package/dist/fp/factories/mptoken-authorize.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Functional MPTokenAuthorize factory — frozen-object style.
+ *
+ * Authorize or deauthorize an account to hold a Multi-Purpose Token (MPT),
+ * or for an issuer running allow-listing, authorize/deauthorize a holder.
+ * Validation happens at construction; there is no way to construct an
+ * invalid tx.
+ *
+ *   import { mptokenAuthorize } from 'xrplt/fp';
+ *   const tx = mptokenAuthorize({
+ *     Account: HOLDER,
+ *     MPTokenIssuanceID: '000004C463C52827307480341125DA0577DEFC38405B0E3E',
+ *   });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Flags: 0x00000001 }); // tfMPTUnauthorize
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/mptokenauthorize
+ *
+ * ## Divergences
+ *
+ * The class-based API at `src/transactions/mptoken-authorize.ts` (and
+ * xrpl.js's `validateMPTokenAuthorize`) is missing two rules that the
+ * canonical sources require. The factory fills them:
+ *
+ *   1. `MPTokenIssuanceID` must be a 48-character uppercase-or-lowercase
+ *      hex string and must not be all-zero.
+ *      The class only checks that the field is a string (`isString`), so
+ *      a wrong-length string, a non-hex string, or all-zero (`'00…00'`,
+ *      48 chars) all pass. The spec declares the field a `UInt192` —
+ *      exactly 24 bytes — and a value of zero is malformed.
+ *      Source: XLS-0033 §3.5.1 (`UInt192` internal type);
+ *              xrpl-dev-portal `mptokenauthorize.md` (Field table:
+ *              `MPTokenIssuanceID | String | UInt192 | Yes`).
+ *
+ *   2. `Holder` must not equal `Account`.
+ *      The class only checks that `Holder`, when present, is a valid XRPL
+ *      address. The spec requires `Holder` to be omitted when the
+ *      transaction is submitted by the holder — i.e. `Holder == Account`
+ *      is malformed.
+ *      Source: XLS-0033 §3.5.1 ("Specifies the holder's address that the
+ *              issuer wants to authorize. Only used for authorization
+ *              /allow-listing; should not be present if submitted by the
+ *              holder.");
+ *              xrpl-dev-portal `mptokenauthorize.md` (Field table, Holder
+ *              description: "must be omitted if submitted by the holder").
+ */
+import type { MPTokenAuthorizeFlagsInterface } from '../../types/flags.js';
+export interface MptokenAuthorizeProps {
+    /** The transaction sender. May be a holder (opt-in) or an issuer (allow-listing). */
+    Account: string;
+    /** The ID of the MPT issuance, encoded as a 48-character hex `UInt192`. */
+    MPTokenIssuanceID: string;
+    /**
+     * Optional holder address. Only valid when the transaction is submitted
+     * by an issuer for allow-listing. Must be omitted when `Account` is
+     * itself the holder.
+     */
+    Holder?: string | undefined;
+    /** Bit-flags for this transaction. Currently only `tfMPTUnauthorize` (0x1) is defined. */
+    Flags?: number | MPTokenAuthorizeFlagsInterface | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface MptokenAuthorize extends Readonly<MptokenAuthorizeProps> {
+    readonly TransactionType: 'MPTokenAuthorize';
+    /** No-op: validation already happened at construction. */
+    validate(): void;
+    /** Serialize to a plain object matching `xrpl.js` input shape. */
+    toJSON(): Record<string, unknown>;
+    /** Derive a new MptokenAuthorize with overrides applied; re-validates. */
+    with(overrides: Partial<MptokenAuthorizeProps>): MptokenAuthorize;
+}
+/**
+ * Build a frozen MPTokenAuthorize. Throws ValidationError on
+ * construction if fields are missing or malformed.
+ *
+ * The class-based version validates lazily (caller must invoke
+ * `.validate()`); this functional version validates at construction.
+ * There is no way to build an invalid tx — `with()` re-runs the factory,
+ * so overrides are re-validated too.
+ */
+export declare function mptokenAuthorize(props: MptokenAuthorizeProps): MptokenAuthorize;
+//# sourceMappingURL=mptoken-authorize.d.ts.map

package/dist/fp/factories/mptoken-authorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-authorize.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-authorize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAY3E,MAAM,WAAW,qBAAqB;IACpC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,GAAG,8BAA8B,GAAG,SAAS,CAAC;IAC5D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,gBACf,SAAQ,QAAQ,CAAC,qBAAqB,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,0DAA0D;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,kEAAkE;IAClE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,0EAA0E;IAC1E,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,gBAAgB,CAAC;CACnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,GAC3B,gBAAgB,CAiElB"}

package/dist/fp/factories/mptoken-authorize.js

@@ -0,0 +1,63 @@
+import { isAccount, isHex, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// `UInt192` internal type: 24 bytes = 48 hex characters.
+const MP_TOKEN_ISSUANCE_ID_LENGTH = 48;
+// ─── Factory ─────────────────────────────────────────────────────────
+/**
+ * Build a frozen MPTokenAuthorize. Throws ValidationError on
+ * construction if fields are missing or malformed.
+ *
+ * The class-based version validates lazily (caller must invoke
+ * `.validate()`); this functional version validates at construction.
+ * There is no way to build an invalid tx — `with()` re-runs the factory,
+ * so overrides are re-validated too.
+ */
+export function mptokenAuthorize(props) {
+    // ─── Account ─── required, must be a valid XRPL classic address.
+    require(props.Account, 'MPTokenAuthorize: Account is required', isAccount);
+    // ─── MPTokenIssuanceID ─── required, 48-char hex, non-zero.
+    if (!isString(props.MPTokenIssuanceID) ||
+        !isHex(props.MPTokenIssuanceID) ||
+        props.MPTokenIssuanceID.length !== MP_TOKEN_ISSUANCE_ID_LENGTH) {
+        throw new ValidationError(`MPTokenAuthorize: MPTokenIssuanceID must be a ${MP_TOKEN_ISSUANCE_ID_LENGTH}-character hex string`);
+    }
+    // All-zero `UInt192` is malformed per the spec.
+    if (/^0+$/u.test(props.MPTokenIssuanceID)) {
+        throw new ValidationError('MPTokenAuthorize: MPTokenIssuanceID must not be zero');
+    }
+    // ─── Holder ─── optional, but if present must be a valid XRPL
+    // address AND must differ from `Account`. The latter rule is the
+    // spec mandate "must be omitted if submitted by the holder" — a
+    // holder submitting this transaction is opting in (or out) for
+    // themselves; specifying themselves as `Holder` is malformed.
+    if (props.Holder !== undefined) {
+        if (!isAccount(props.Holder)) {
+            throw new ValidationError('MPTokenAuthorize: invalid Holder');
+        }
+        if (props.Holder === props.Account) {
+            throw new ValidationError('MPTokenAuthorize: Holder must be omitted when Account is itself the holder');
+        }
+    }
+    return buildFrozenTx('MPTokenAuthorize', props, {
+        validate() {
+            // Construction-time validation is the contract.
+        },
+        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 mptokenAuthorize(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=mptoken-authorize.js.map

package/dist/fp/factories/mptoken-authorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-authorize.js","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-authorize.ts"],"names":[],"mappings":"AA+CA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnE,wEAAwE;AAExE,yDAAyD;AACzD,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAgCvC,wEAAwE;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA4B;IAE5B,kEAAkE;IAClE,OAAO,CACL,KAAK,CAAC,OAAO,EACb,uCAAuC,EACvC,SAAS,CACV,CAAC;IAEF,6DAA6D;IAC7D,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAClC,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAC/B,KAAK,CAAC,iBAAiB,CAAC,MAAM,KAAK,2BAA2B,EAC9D,CAAC;QACD,MAAM,IAAI,eAAe,CACvB,iDAAiD,2BAA2B,uBAAuB,CACpG,CAAC;IACJ,CAAC;IACD,gDAAgD;IAChD,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CACvB,sDAAsD,CACvD,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,iEAAiE;IACjE,gEAAgE;IAChE,+DAA+D;IAC/D,8DAA8D;IAC9D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,eAAe,CACvB,4EAA4E,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,aAAa,CAClB,kBAAkB,EAClB,KAAK,EACL;QACE,QAAQ;YACN,gDAAgD;QAClD,CAAC;QACD,MAAM;YACJ,MAAM,IAAI,GAA4B,EAAE,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,MAAM;oBAAE,SAAS;gBACjE,MAAM,CAAC,GAAI,IAA2C,CAAC,CAAC,CAAC,CAAC;gBAC1D,IAAI,CAAC,KAAK,SAAS;oBAAE,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAEF,SAAyC;YAEzC,OAAO,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/fp/factories/mptoken-issuance-create.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Functional MPTokenIssuanceCreate factory — frozen-object style.
+ *
+ * Creates a new Multi-Purpose Token (MPT) issuance on the ledger.
+ * Validation happens at construction; there is no way to construct an
+ * invalid tx.
+ *
+ *   import { mptokenIssuanceCreate } from 'xrplt/fp';
+ *   const tx = mptokenIssuanceCreate({ Account, AssetScale: 2, MaximumAmount: '1000000' });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ TransferFee: 100 });
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/mptokenissuancecreate
+ */
+import type { MPTokenIssuanceCreateFlagsInterface } from '../../types/flags.js';
+export interface MptokenIssuanceCreateProps {
+    /** The unique address of the transaction sender (the MPT issuer). */
+    Account: string;
+    /** Decimal precision for the MPT (0–15). Determines share conversion scale. */
+    AssetScale?: number | undefined;
+    /**
+     * Ledger entry ID of a permissioned domain restricting access. Requires
+     * `tfMPTRequireAuth` to be set. Requires both `PermissionedDomains`
+     * and `SingleAssetVault` amendments enabled on the ledger.
+     */
+    DomainID?: string | undefined;
+    /**
+     * Secondary-sale transfer fee in basis points (0–50,000). Non-zero
+     * values require the `tfMPTCanTransfer` flag.
+     */
+    TransferFee?: number | undefined;
+    /**
+     * Maximum amount of this MPT that can ever be issued, encoded as a
+     * base-10 number string. Current spec allows up to 2^63-1.
+     */
+    MaximumAmount?: string | undefined;
+    /**
+     * Arbitrary metadata about this issuance. Hex-encoded; 0 < length <= 1024
+     * bytes after decoding.
+     */
+    MPTokenMetadata?: string | undefined;
+    /**
+     * Bitmask of flags declaring which fields and capability flags are
+     * immutable from issuance onward. Requires the `DynamicMPT` amendment.
+     */
+    ImmutableFlags?: number | undefined;
+    /** Bit-flags for this transaction. */
+    Flags?: number | MPTokenIssuanceCreateFlagsInterface | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface MptokenIssuanceCreate extends Readonly<MptokenIssuanceCreateProps> {
+    readonly TransactionType: 'MPTokenIssuanceCreate';
+    /** No-op: validation already happened at construction. */
+    validate(): void;
+    /** Serialize to a plain object matching `xrpl.js` input shape. */
+    toJSON(): Record<string, unknown>;
+    /** Derive a new MptokenIssuanceCreate with overrides applied; re-validates. */
+    with(overrides: Partial<MptokenIssuanceCreateProps>): MptokenIssuanceCreate;
+}
+/**
+ * Build a frozen MPTokenIssuanceCreate. Throws ValidationError on
+ * construction if fields are missing or malformed.
+ *
+ * The class-based version validates lazily (caller must invoke
+ * `.validate()`); this functional version validates at construction.
+ * There is no way to build an invalid tx — `with()` re-runs the factory,
+ * so overrides are re-validated too.
+ */
+export declare function mptokenIssuanceCreate(props: MptokenIssuanceCreateProps): MptokenIssuanceCreate;
+//# sourceMappingURL=mptoken-issuance-create.d.ts.map

package/dist/fp/factories/mptoken-issuance-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-issuance-create.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-issuance-create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,sBAAsB,CAAC;AAkChF,MAAM,WAAW,0BAA0B;IACzC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,GAAG,mCAAmC,GAAG,SAAS,CAAC;IACjE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,qBACf,SAAQ,QAAQ,CAAC,0BAA0B,CAAC;IAC5C,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAClD,0DAA0D;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,kEAAkE;IAClE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+EAA+E;IAC/E,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,qBAAqB,CAAC;CAC7E;AAID;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CA6IvB"}