xrpjson 0.1.0

package/dist/fp/factories/nftoken-create-offer.js

@@ -0,0 +1,212 @@
+import { isAccount, isAmount, isHex, isIssuedCurrencyAmount, isMPTAmount, isNumber, isRecord, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// XLS-20 / xrpl.org: Expiration is UInt32.
+const UINT32_MIN = 0;
+const UINT32_MAX = 0xffffffff;
+// xrpl.org `nftokencreateoffer.md` line 39 / XLS-20 §1.5.4 line 682:
+// NFTokenID is Hash256 / UInt256 — a 64-character hex string.
+const NFTOKEN_ID_LENGTH = 64;
+// IOU currency shape (3 ASCII or 40 hex chars).
+const CURRENCY_ASCII_LENGTH = 3;
+const CURRENCY_HEX_LENGTH = 40;
+// MPT issuance ID window (matches OfferCreate / AmmCreate policy).
+const MPT_ISSUANCE_ID_MIN = 24;
+const MPT_ISSUANCE_ID_MAX = 48;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/** Non-negative base-10 integer string (XRPLNumber). */
+function isXrplNumber(value) {
+    return isString(value) && /^[0-9]+$/u.test(value);
+}
+/**
+ * Validate the deep shape of an Amount (XRP string / IOU / MPT). The
+ * class delegates to `isAmount`, which only checks key presence. This
+ * helper enforces the deeper invariants that rippled actually checks
+ * (`temBAD_AMOUNT`, currency length, valid issuer, etc.).
+ *
+ * `path` is just for error messages ("Amount", "Amount" — single field
+ * here, but kept parametric so future factories can reuse).
+ */
+function validateAmount(amount, path) {
+    if (!isAmount(amount)) {
+        throw new ValidationError(`NFTokenCreateOffer: ${path} must be a valid Amount (XRP string, IOU, or MPT form)`);
+    }
+    // XRP path: non-negative base-10 integer string.
+    if (isString(amount)) {
+        if (!isXrplNumber(amount)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path} (XRP) must be a non-negative base-10 integer string`);
+        }
+        return;
+    }
+    // IOU path.
+    if (isIssuedCurrencyAmount(amount)) {
+        const ccy = amount.currency;
+        if (ccy.length !== CURRENCY_ASCII_LENGTH &&
+            ccy.length !== CURRENCY_HEX_LENGTH) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.currency must be ${CURRENCY_ASCII_LENGTH} ASCII or ${CURRENCY_HEX_LENGTH} hex chars (actual: ${ccy.length})`);
+        }
+        if (ccy.length === CURRENCY_HEX_LENGTH && !isHex(ccy)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.currency (40-char form) must be hex`);
+        }
+        if (!isAccount(amount.issuer)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.issuer must be a valid XRPL account address`);
+        }
+        if (!isXrplNumber(amount.value)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        return;
+    }
+    // MPT path.
+    if (isMPTAmount(amount)) {
+        const mptid = amount.mpt_issuance_id;
+        if (mptid.length < MPT_ISSUANCE_ID_MIN ||
+            mptid.length > MPT_ISSUANCE_ID_MAX ||
+            !isHex(mptid)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.mpt_issuance_id must be a ${MPT_ISSUANCE_ID_MIN}-${MPT_ISSUANCE_ID_MAX} character hex string`);
+        }
+        if (!isXrplNumber(amount.value)) {
+            throw new ValidationError(`NFTokenCreateOffer: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        return;
+    }
+    // Unreachable — defensive.
+    throw new ValidationError(`NFTokenCreateOffer: ${path} must be a valid Amount (XRP string, IOU, or MPT form)`);
+}
+/**
+ * Returns the parsed numeric value of an Amount, matching the
+ * `parseAmountValue` semantics from xrpl.js (treats string forms as
+ * base-10 integers). Returns NaN if unparseable.
+ *
+ * For IOU/MPT we only need to check `value === '0'`; for XRP the same.
+ * Used to enforce "Amount > 0 for buy offers".
+ */
+function amountToNumber(amount) {
+    if (isString(amount)) {
+        if (!isXrplNumber(amount))
+            return Number.NaN;
+        return Number(amount);
+    }
+    if (isIssuedCurrencyAmount(amount) || isMPTAmount(amount)) {
+        if (!isXrplNumber(amount.value))
+            return Number.NaN;
+        return Number(amount.value);
+    }
+    return Number.NaN;
+}
+/** Decode the boolean-map Flags form to a numeric bitmask. */
+function flagsToNumber(flags) {
+    if (flags === undefined)
+        return 0;
+    if (typeof flags === 'number')
+        return flags;
+    let n = 0;
+    if (flags.tfSellNFToken)
+        n |= 0x00000001;
+    return n;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function nftokenCreateOffer(props) {
+    // ── Account ── required, must be a valid XRPL classic / X-address.
+    require(props.Account, 'NFTokenCreateOffer: Account is required', isAccount);
+    // ── NFTokenID ── required, 64-char hex.
+    if (!isString(props.NFTokenID)) {
+        throw new ValidationError('NFTokenCreateOffer: NFTokenID is required and must be a string');
+    }
+    if (props.NFTokenID.length !== NFTOKEN_ID_LENGTH || !isHex(props.NFTokenID)) {
+        throw new ValidationError(`NFTokenCreateOffer: NFTokenID must be a ${NFTOKEN_ID_LENGTH}-character hex string (Hash256)`);
+    }
+    // ── Amount ── required, deep shape check, then direction-aware
+    //               positivity (buy ⇒ >0; sell ⇒ ≥0 with zero only for XRP).
+    validateAmount(props.Amount, 'Amount');
+    // ── Flags ── numeric / boolean-map type check (must run BEFORE the
+    //              sell-vs-buy direction logic so callers passing bad
+    //              numeric values see a clear "Flags must be a
+    //              non-negative integer" error rather than a downstream
+    //              Owner/Amount mismatch).
+    if (props.Flags !== undefined) {
+        if (typeof props.Flags !== 'number' &&
+            !isRecord(props.Flags)) {
+            throw new ValidationError('NFTokenCreateOffer: Flags must be a non-negative integer or NFTokenCreateOfferFlagsInterface object');
+        }
+        if (typeof props.Flags === 'number') {
+            if (!Number.isInteger(props.Flags) || props.Flags < 0) {
+                throw new ValidationError('NFTokenCreateOffer: Flags must be a non-negative integer');
+            }
+        }
+    }
+    // Decode the Flags bit early so direction-specific guards can read it.
+    const numericFlags = flagsToNumber(props.Flags);
+    const TF_SELL_NFTOKEN = 0x00000001;
+    const isSell = (numericFlags & TF_SELL_NFTOKEN) === TF_SELL_NFTOKEN;
+    if (isSell) {
+        // Sell offer: Amount=0 is only legal for XRP (XLS-20 §1.5.4 line 694).
+        const amtNum = amountToNumber(props.Amount);
+        if (amtNum === 0 && !isString(props.Amount)) {
+            throw new ValidationError('NFTokenCreateOffer: sell offer with Amount=0 is only valid for XRP (gratis giveaway); IOU/MPT Amount must be positive');
+        }
+        // Sell offer: Owner must not be present (xrpl.js validateNFTokenSellOfferCases).
+        if (props.Owner !== undefined) {
+            throw new ValidationError('NFTokenCreateOffer: Owner must not be present for sell offers (tfSellNFToken)');
+        }
+    }
+    else {
+        // Buy offer: Owner required and Amount must be strictly > 0.
+        if (props.Owner === undefined) {
+            throw new ValidationError('NFTokenCreateOffer: Owner is required for buy offers (no tfSellNFToken flag)');
+        }
+        if (!isAccount(props.Owner)) {
+            throw new ValidationError('NFTokenCreateOffer: Owner must be a valid XRPL account address');
+        }
+        const amtNum = amountToNumber(props.Amount);
+        if (!(amtNum > 0)) {
+            throw new ValidationError('NFTokenCreateOffer: Amount must be greater than 0 for buy offers (temBAD_AMOUNT)');
+        }
+    }
+    // ── Destination ── optional, must be a valid account and != Account.
+    if (props.Destination !== undefined) {
+        if (!isAccount(props.Destination)) {
+            throw new ValidationError('NFTokenCreateOffer: Destination must be a valid XRPL account address');
+        }
+        if (props.Destination === props.Account) {
+            throw new ValidationError('NFTokenCreateOffer: Destination and Account must not be equal');
+        }
+    }
+    // ── Owner ≠ Account (when Owner present, i.e. buy offers) ──
+    if (props.Owner !== undefined && props.Owner === props.Account) {
+        throw new ValidationError('NFTokenCreateOffer: Owner and Account must not be equal');
+    }
+    // ── Expiration ── optional, UInt32.
+    if (props.Expiration !== undefined) {
+        if (!isNumber(props.Expiration) ||
+            !Number.isInteger(props.Expiration) ||
+            props.Expiration < UINT32_MIN ||
+            props.Expiration > UINT32_MAX) {
+            throw new ValidationError(`NFTokenCreateOffer: Expiration must be a UInt32 in [${UINT32_MIN}, ${UINT32_MAX}]`);
+        }
+    }
+    // ── Flags ── numeric / boolean-map type check is run above (before
+    //              direction logic). The validation in this block ensures
+    //              callers get a clear shape error before any cross-field
+    //              rules fire.
+    return buildFrozenTx('NFTokenCreateOffer', 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 nftokenCreateOffer(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=nftoken-create-offer.js.map

package/dist/fp/factories/nftoken-create-offer.js.map

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

package/dist/fp/factories/nftoken-mint.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Functional NFTokenMint factory — frozen-object style.
+ *
+ * Creates a new NFToken (NFT) on the ledger. Validation happens at
+ * construction; there is no way to construct an invalid tx.
+ *
+ *   import { nftokenMint } from 'xrplt/fp';
+ *   const tx = nftokenMint({ Account, NFTokenTaxon: 0 });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ TransferFee: 314, Flags: { tfTransferable: true } });
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/nftokenmint
+ * @see https://github.com/XRPLF/xrpl.js/blob/main/packages/xrpl/src/models/transactions/NFTokenMint.ts
+ * @see XLS-0020 (Non-Fungible Tokens)
+ * @see XLS-0046 (Dynamic Non-Fungible Tokens — tfMutable)
+ *
+ * ## Divergences
+ *
+ * Compared with `src/transactions/nftoken-mint.ts`, this factory adds
+ * guards the class skips (or that xrpl.js / xrpl.org / XLS-20 / XLS-46
+ * mandate but the class omits):
+ *
+ * - **`Issuer` must not equal `Account`** — when both are present and
+ *   identical, the transaction cannot be authorized to mint on its own
+ *   behalf. xrpl.js's `validateNFTokenMint` enforces this explicitly
+ *   (lines 149–153), but our class source does not.
+ *   - Source: xrpl.js
+ *     `~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/NFTokenMint.ts`
+ *     lines 149–153.
+ *
+ * - **`URI` must be hex-encoded** — XLS-20 §1.3.3 and xrpl.org both state
+ *   the URI is a BLOB and must be hex-encoded in JSON. Our class accepts
+ *   any string.
+ *   - Source: XLS-20 §1.3.3
+ *     (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0020-non-fungible-tokens/README.md`
+ *     line 134).
+ *   - Source: xrpl.org `nftokenmint.md` ("This field must be hex-encoded")
+ *     (`~/.mavis/docs.local/xrpl-dev-portal/repo/docs/references/protocol/transactions/types/nftokenmint.md`
+ *     line 53).
+ *
+ * - **`URI` must not be an empty string** — xrpl.js's `validateNFTokenMint`
+ *   rejects `''` (line 157–159); the class accepts it. XLS-20 §1.3.3 says
+ *   the field is limited to 256 bytes but does not speak to empty; we
+ *   follow xrpl.js here to mirror the on-ledger behavior.
+ *   - Source: xrpl.js `NFTokenMint.ts` lines 157–159.
+ *
+ * - **`URI` length capped at 256 bytes (512 hex chars)** — XLS-20 §1.3.3
+ *   states the BLOB is limited to 256 bytes. The class does not enforce
+ *   this; the factory does. We also reject odd-length hex.
+ *   - Source: XLS-20 §1.3.3 line 134.
+ *   - Source: xrpl.org `nftokenmint.md` line 53 ("limited to a maximum
+ *     length of 256 bytes").
+ *
+ * - **`NFTokenTaxon` is a UInt32 (0 ≤ taxon ≤ 2^32-1)** — the ledger type
+ *   is `UInt32`. The class only checks `isNumber`, allowing negatives
+ *   and non-integers.
+ *   - Source: xrpl.org `nftokenmint.md` line 50 ("UInt32").
+ *   - Source: XLS-20 §1.5.1
+ *     (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0020-non-fungible-tokens/README.md`
+ *     line 344: "Taxons have a valid range from 0x0 to 0xFFFFFFFF").
+ *
+ * - **`TransferFee` requires `tfTransferable`** — XLS-20 §1.5.1 (line 367)
+ *   and xrpl.org `nftokenmint.md` (line 52) both state: "If this field
+ *   is provided, the transaction MUST have the `tfTransferable` flag
+ *   enabled." The class does not check this coupling.
+ *   - Source: XLS-20 §1.5.1 line 367: "The field MUST NOT be present if
+ *     the `tfTransferable` flag is not set. If it is, the transaction
+ *     should fail and a fee should be claimed."
+ *   - Source: xrpl.org `nftokenmint.md` line 52.
+ *
+ * - **`TransferFee` must be an integer** — the class only checks range.
+ *   The ledger type is `UInt16`, so fractional values must be rejected.
+ *   - Source: XLS-20 §1.5.1 line 363 ("UINT16").
+ *   - Source: xrpl.org `nftokenmint.md` line 52 ("UInt16").
+ *
+ * - **`Expiration` must be a UInt32** — the class allows any number.
+ *   The ledger type is `UInt32`; we reject negatives, fractions, and
+ *   values > 4294967295.
+ *   - Source: xrpl.org `nftokenmint.md` line 55 ("UInt32").
+ *
+ * - **`tfTrustLine` flag (0x00000004) is rejected** — the
+ *   `fixRemoveNFTokenAutoTrustLine` amendment makes `tfTrustLine` invalid.
+ *   xrpl.org's Error Cases table flags this explicitly: "If the
+ *   fixRemoveNFTokenAutoTrustLine amendment is enabled, the tfTrustLine
+ *   flag causes this error (`temINVALID_FLAG`)." The class does not
+ *   guard against it.
+ *   - Source: xrpl.org `nftokenmint.md` line 117.
+ *
+ * - **Cross-field: `Expiration` AND `Destination` together require
+ *   `Amount`** — xrpl.js's `validateNFTokenMint` (lines 169–175) treats
+ *   `Expiration`/`Destination` as requiring `Amount` together, but the
+ *   error wording is the single-message form. We enforce the same
+ *   single-check rule (Presence of either ⇒ `Amount` required). The
+ *   class enforces this per-field.
+ *   - Source: xrpl.js `NFTokenMint.ts` lines 169–175.
+ *
+ * - **`Amount` for XRP allows `"0"` (gratis giveaway)** — XLS-20 §1.5.1
+ *   (line 694) and xrpl.org `nftokenmint.md` (line 54) both explicitly
+ *   permit zero-amount XRP NFTokenMint offers (giving the token away
+ *   gratis). For IOU/MPT, the amount must be non-zero. We do not reject
+ *   Amount here — the `isAmount` helper accepts the shape, and we leave
+ *   the zero-vs-nonzero distinction to the ledger. (Divergence is
+ *   documented for awareness; this guard is intentionally permissive so
+ *   the factory works for both gratis and priced mint offers.)
+ *   - Source: XLS-20 §1.5.1 line 694.
+ *   - Source: xrpl.org `nftokenmint.md` line 54.
+ *
+ * - **`tfMutable` flag (0x00000010) accepted (XLS-46 dNFT)** — the
+ *   Dynamic NFT amendment introduces this flag. The class types it but
+ *   does not document it; we expose and validate it the same way as
+ *   the other flags. (No extra validation is required — tfMutable is a
+ *   simple boolean toggle that affects future NFTokenModify calls.)
+ *   - Source: XLS-0046 §3.1
+ *     (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0046-dynamic-non-fungible-tokens/README.md`
+ *     line 47).
+ *   - Source: xrpl.org `dynamic-nfts.md`
+ *     (`~/.mavis/docs.local/xrpl-dev-portal/repo/docs/concepts/tokens/nfts/dynamic-nfts.md`
+ *     line 13: "enable the `tfMutable` flag (`0x00000010`) to make the NFT
+ *     mutable.").
+ */
+import type { Amount } from '../../types/amounts.js';
+import type { NFTokenMintFlagsInterface } from '../../types/flags.js';
+export interface NftokenMintProps {
+    Account: string;
+    /** Taxon for the NFToken series. UInt32 (0..2^32-1). */
+    NFTokenTaxon: number;
+    /** Issuer (when minting on behalf of another authorized account). */
+    Issuer?: string | undefined;
+    /** Secondary-sale transfer fee in 1/10 bps (0–50000). Requires tfTransferable. */
+    TransferFee?: number | undefined;
+    /** Arbitrary data URI, hex-encoded, ≤ 256 bytes. */
+    URI?: string | undefined;
+    /** Amount for an attached sell offer. Zero is permitted for XRP. */
+    Amount?: Amount | undefined;
+    /** Offer expiration in seconds since Ripple Epoch (UInt32). Requires Amount. */
+    Expiration?: number | undefined;
+    /** Restricts offer acceptance to one account. Requires Amount. */
+    Destination?: string | undefined;
+    /**
+     * Bit-flags. Either a numeric bitmask (see `NFTokenMintFlags`) or the
+     * boolean-map `NFTokenMintFlagsInterface` form (tfBurnable,
+     * tfOnlyXRP, tfTransferable, tfMutable).
+     */
+    Flags?: number | NFTokenMintFlagsInterface | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface NftokenMint extends Readonly<NftokenMintProps> {
+    readonly TransactionType: 'NFTokenMint';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<NftokenMintProps>): NftokenMint;
+}
+export declare function nftokenMint(props: NftokenMintProps): NftokenMint;
+//# sourceMappingURL=nftoken-mint.d.ts.map

package/dist/fp/factories/nftoken-mint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nftoken-mint.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/nftoken-mint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuHG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AA2BtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAAC;IACvD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IAC7D,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC;IACxC,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAAC;CACzD;AA6BD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAyKhE"}

package/dist/fp/factories/nftoken-mint.js

@@ -0,0 +1,165 @@
+import { isAccount, isAmount, isHex, isIssuedCurrencyAmount, isMPTAmount, isNumber, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// XLS-20 / xrpl.org: TransferFee is UInt16, max 50000 (50.000%).
+const MAX_TRANSFER_FEE = 50_000;
+// XLS-20 / xrpl.org: NFTokenTaxon is UInt32.
+const MAX_NFTOKEN_TAXON = 0xffffffff;
+// XLS-20 / xrpl.org: Expiration is UInt32.
+const MAX_EXPIRATION = 0xffffffff;
+// XLS-20 / xrpl.org: URI is a BLOB with max 256 bytes.
+const MAX_URI_BYTES = 256;
+const MAX_URI_HEX_CHARS = MAX_URI_BYTES * 2;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Translate the boolean-map `NFTokenMintFlagsInterface` into a numeric
+ * bitmask. Numeric `Flags` pass through unchanged.
+ *
+ * tfTrustLine is intentionally NOT translated — it is deprecated by the
+ * `fixRemoveNFTokenAutoTrustLine` amendment. Callers passing
+ * `{ tfTrustLine: true }` get the bit set anyway, and the post-translation
+ * rejection guard catches it.
+ */
+function flagsToNumber(flags) {
+    if (flags === undefined)
+        return 0;
+    if (typeof flags === 'number')
+        return flags;
+    let n = 0;
+    if (flags.tfBurnable)
+        n |= 0x00000001;
+    if (flags.tfOnlyXRP)
+        n |= 0x00000002;
+    if (flags.tfTrustLine)
+        n |= 0x00000004;
+    if (flags.tfTransferable)
+        n |= 0x00000008;
+    if (flags.tfMutable)
+        n |= 0x00000010;
+    return n;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function nftokenMint(props) {
+    // ── Account ── required, must be a valid XRPL classic address.
+    require(props.Account, 'NFTokenMint: Account is required', isAccount);
+    // ── NFTokenTaxon ── required, integer in [0, 2^32-1].
+    if (!isNumber(props.NFTokenTaxon) ||
+        !Number.isInteger(props.NFTokenTaxon) ||
+        props.NFTokenTaxon < 0 ||
+        props.NFTokenTaxon > MAX_NFTOKEN_TAXON) {
+        throw new ValidationError(`NFTokenMint: NFTokenTaxon must be an integer in [0, ${MAX_NFTOKEN_TAXON}] (UInt32)`);
+    }
+    // ── Issuer ── optional, must be a valid XRPL account, and must NOT
+    //              equal Account (xrpl.js validateNFTokenMint lines 149-153).
+    if (props.Issuer !== undefined) {
+        if (!isAccount(props.Issuer)) {
+            throw new ValidationError('NFTokenMint: Issuer must be a valid XRPL account address');
+        }
+        if (props.Issuer === props.Account) {
+            throw new ValidationError('NFTokenMint: Issuer must not be equal to Account');
+        }
+    }
+    // ── TransferFee ── optional, integer in [0, 50000], requires
+    //                   tfTransferable flag (XLS-20 §1.5.1 line 367).
+    if (props.TransferFee !== undefined) {
+        if (!isNumber(props.TransferFee) ||
+            !Number.isInteger(props.TransferFee) ||
+            props.TransferFee < 0 ||
+            props.TransferFee > MAX_TRANSFER_FEE) {
+            throw new ValidationError(`NFTokenMint: TransferFee must be an integer in [0, ${MAX_TRANSFER_FEE}]`);
+        }
+    }
+    // ── URI ── optional, non-empty hex, even length, ≤ 256 bytes
+    //          (512 hex chars). Odd-length hex is invalid by the BLOB spec.
+    if (props.URI !== undefined) {
+        if (!isString(props.URI) || !isHex(props.URI)) {
+            throw new ValidationError('NFTokenMint: URI must be a hex-encoded string');
+        }
+        if (props.URI.length === 0) {
+            throw new ValidationError('NFTokenMint: URI must not be an empty string');
+        }
+        if (props.URI.length % 2 !== 0) {
+            throw new ValidationError('NFTokenMint: URI must have an even number of hex characters (BLOB is byte-aligned)');
+        }
+        if (props.URI.length > MAX_URI_HEX_CHARS) {
+            throw new ValidationError(`NFTokenMint: URI exceeds ${MAX_URI_BYTES} bytes (${MAX_URI_HEX_CHARS} hex chars); actual: ${props.URI.length}`);
+        }
+    }
+    // ── Amount ── optional, must be a valid Amount (XRP string / IOU / MPT).
+    if (props.Amount !== undefined && !isAmount(props.Amount)) {
+        throw new ValidationError('NFTokenMint: Amount must be a valid Amount (XRP drops string, IOU object, or MPT object)');
+    }
+    // ── Expiration ── optional, requires Amount, UInt32 in [0, 2^32-1].
+    if (props.Expiration !== undefined) {
+        if (props.Amount === undefined) {
+            throw new ValidationError('NFTokenMint: Expiration requires Amount');
+        }
+        if (!isNumber(props.Expiration) ||
+            !Number.isInteger(props.Expiration) ||
+            props.Expiration < 0 ||
+            props.Expiration > MAX_EXPIRATION) {
+            throw new ValidationError(`NFTokenMint: Expiration must be a UInt32 integer in [0, ${MAX_EXPIRATION}]`);
+        }
+    }
+    // ── Destination ── optional, requires Amount, must be valid XRPL account.
+    if (props.Destination !== undefined) {
+        if (props.Amount === undefined) {
+            throw new ValidationError('NFTokenMint: Destination requires Amount');
+        }
+        if (!isAccount(props.Destination)) {
+            throw new ValidationError('NFTokenMint: Destination must be a valid XRPL account address');
+        }
+    }
+    // ── Flags ── translate + reject deprecated tfTrustLine.
+    const numericFlags = flagsToNumber(props.Flags);
+    const TF_TRUST_LINE = 0x00000004;
+    if ((numericFlags & TF_TRUST_LINE) === TF_TRUST_LINE) {
+        throw new ValidationError('NFTokenMint: tfTrustLine (0x4) is deprecated by the fixRemoveNFTokenAutoTrustLine amendment and cannot be set');
+    }
+    // ── TransferFee ↔ tfTransferable coupling ── XLS-20 §1.5.1 line 367.
+    const TF_TRANSFERABLE = 0x00000008;
+    if (props.TransferFee !== undefined &&
+        (numericFlags & TF_TRANSFERABLE) !== TF_TRANSFERABLE) {
+        throw new ValidationError('NFTokenMint: TransferFee requires the tfTransferable flag (0x8) to be set');
+    }
+    // ── Amount shape sub-checks (when IOU/MPT, value must be a non-negative
+    //    base-10 integer string; issuer must be a valid account for IOU).
+    if (props.Amount !== undefined) {
+        if (isIssuedCurrencyAmount(props.Amount)) {
+            if (!isAccount(props.Amount.issuer)) {
+                throw new ValidationError('NFTokenMint: Amount.issuer must be a valid XRPL account address');
+            }
+            if (!isString(props.Amount.value) ||
+                !/^[0-9]+$/u.test(props.Amount.value)) {
+                throw new ValidationError('NFTokenMint: Amount.value must be a non-negative base-10 integer string');
+            }
+        }
+        else if (isMPTAmount(props.Amount)) {
+            if (!isString(props.Amount.value) ||
+                !/^[0-9]+$/u.test(props.Amount.value)) {
+                throw new ValidationError('NFTokenMint: Amount.value must be a non-negative base-10 integer string');
+            }
+        }
+    }
+    return buildFrozenTx('NFTokenMint', 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 nftokenMint(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=nftoken-mint.js.map

package/dist/fp/factories/nftoken-mint.js.map

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

package/dist/fp/factories/nftoken-modify.d.ts

@@ -0,0 +1,28 @@
+export interface NftokenModifyProps {
+    Account: string;
+    /** The 64-char hex (UInt256) identifier of the dynamic NFToken to
+     *  modify. */
+    NFTokenID: string;
+    /** New URI (hex-encoded, ≤ 256 bytes). Omit to delete the existing
+     *  URI on the token. */
+    URI?: string | undefined;
+    /** Current owner of the NFToken, if different from Account. Used by
+     *  the issuer / authorized minter to modify a token held by another
+     *  account. */
+    Owner?: string | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+    /** Bit-flags (numeric bitmask). NFTokenModify itself defines no
+     *  transaction-specific flags; only `tfFullyCanonicalSig` (global)
+     *  is normally meaningful. Accepted for parity with the base
+     *  transaction shape. */
+    Flags?: number | undefined;
+}
+export interface NftokenModify extends Readonly<NftokenModifyProps> {
+    readonly TransactionType: 'NFTokenModify';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<NftokenModifyProps>): NftokenModify;
+}
+export declare function nftokenModify(props: NftokenModifyProps): NftokenModify;
+//# sourceMappingURL=nftoken-modify.d.ts.map

package/dist/fp/factories/nftoken-modify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nftoken-modify.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/nftoken-modify.ts"],"names":[],"mappings":"AA8IA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB;kBACc;IACd,SAAS,EAAE,MAAM,CAAC;IAClB;4BACwB;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;mBAEe;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;6BAGyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,aACf,SAAQ,QAAQ,CAAC,kBAAkB,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAAC;CAC7D;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAiGtE"}