xrpjson 0.1.0

package/dist/fp/factories/mptoken-issuance-set.js

@@ -0,0 +1,333 @@
+import { isAccount, isHex, isNumber, isRecord, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// Maximum allowed `TransferFee` in basis points (0.000% — 50.000%).
+// xrpl.js `MPTokenIssuanceCreate.ts:22` exports MAX_TRANSFER_FEE = 50000.
+const MAX_TRANSFER_FEE = 50_000;
+// Maximum MPTokenMetadata length in bytes (after hex decoding).
+// xrpl.js `utils/mptokenMetadata.ts:12` exports MAX_MPT_META_BYTE_LENGTH = 1024.
+const MAX_METADATA_BYTES = 1024;
+// MPTokenIssuanceID is a UINT192 — 24 bytes = 48 hex chars.
+const MP_TOKEN_ISSUANCE_ID_LENGTH = 48;
+// Encryption keys are 33-byte compressed EC-ElGamal public keys — 66 hex chars.
+const CONFIDENTIAL_EC_POINT_BYTES = 33;
+const CONFIDENTIAL_EC_POINT_HEX_LENGTH = CONFIDENTIAL_EC_POINT_BYTES * 2;
+// Per-tx flag bits (XLS-0033 §3.3.1.1 + DynamicMPT + ConfidentialTransfer).
+// Mirrors ripple-binary-codec definitions.json
+//   packages/ripple-binary-codec/src/enums/definitions.json:5253–5262
+// and xrpl.js MPTokenIssuanceSet.ts:37–76.
+const TF_MPT_LOCK = 0x00000001;
+const TF_MPT_UNLOCK = 0x00000002;
+const TF_MPT_SET_CAN_LOCK = 0x00000004;
+const TF_MPT_SET_REQUIRE_AUTH = 0x00000008;
+const TF_MPT_SET_CAN_ESCROW = 0x00000010;
+const TF_MPT_SET_CAN_TRADE = 0x00000020;
+const TF_MPT_SET_CAN_TRANSFER = 0x00000040;
+const TF_MPT_SET_CAN_CLAWBACK = 0x00000080;
+const TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE = 0x00000100;
+// Bitmask of all per-tx flags, plus the two global flags inherited
+// from the base transaction (GlobalFlagsInterface in ripple-binary-codec
+// `definitions.json:5318–5321`). The factory accepts the global bits
+// because they are valid on every transaction; the `0x7fffffff` mask
+// below only excludes the sign bit (0x80000000), which is
+// `tfFullyCanonicalSig` and IS a defined global flag.
+const KNOWN_PER_TX_FLAG_BITS = TF_MPT_LOCK |
+    TF_MPT_UNLOCK |
+    TF_MPT_SET_CAN_LOCK |
+    TF_MPT_SET_REQUIRE_AUTH |
+    TF_MPT_SET_CAN_ESCROW |
+    TF_MPT_SET_CAN_TRADE |
+    TF_MPT_SET_CAN_TRANSFER |
+    TF_MPT_SET_CAN_CLAWBACK |
+    TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE |
+    0x40000000 | // tfInnerBatchTxn (global)
+    0x80000000; // tfFullyCanonicalSig (global)
+// Bitmask of the seven `tfMPTSet*` capability-setting flags. Any of
+// these triggers a "mutation" per the spec.
+const TF_MPT_SET_CAPABILITY_MASK = TF_MPT_SET_CAN_LOCK |
+    TF_MPT_SET_REQUIRE_AUTH |
+    TF_MPT_SET_CAN_ESCROW |
+    TF_MPT_SET_CAN_TRADE |
+    TF_MPT_SET_CAN_TRANSFER |
+    TF_MPT_SET_CAN_CLAWBACK |
+    TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE;
+// Known `tif*` bits (declare fields/capabilities immutable). Mirrors
+// `src/types/flags.ts:271–281` and xrpl.js
+// MPTokenIssuanceCreate.ts:77–113.
+const KNOWN_IMMUTABLE_FLAG_BITS = 0x00000002 | // tifMPTCanLock
+    0x00000004 | // tifMPTRequireAuth
+    0x00000008 | // tifMPTCanEscrow
+    0x00000010 | // tifMPTCanTrade
+    0x00000020 | // tifMPTCanTransfer
+    0x00000040 | // tifMPTCanClawback
+    0x00000080 | // tifMPTCanHoldConfidentialBalance
+    0x00010000 | // tifMPTMetadata
+    0x00020000; // tifMPTTransferFee
+// Closed set of valid boolean keys for the `Flags` map, with their
+// numeric bit values. Mirrors xrpl.js's `convertTxFlagsToNumber`
+// (packages/xrpl/src/models/utils/flags.ts:174–201), but localized for
+// MPTokenIssuanceSet so the factory has no cross-tx dependency.
+const VALID_FLAGS_INTERFACE_KEYS = new Map([
+    ['tfMPTLock', TF_MPT_LOCK],
+    ['tfMPTUnlock', TF_MPT_UNLOCK],
+    ['tfMPTSetCanLock', TF_MPT_SET_CAN_LOCK],
+    ['tfMPTSetRequireAuth', TF_MPT_SET_REQUIRE_AUTH],
+    ['tfMPTSetCanEscrow', TF_MPT_SET_CAN_ESCROW],
+    ['tfMPTSetCanTrade', TF_MPT_SET_CAN_TRADE],
+    ['tfMPTSetCanTransfer', TF_MPT_SET_CAN_TRANSFER],
+    ['tfMPTSetCanClawback', TF_MPT_SET_CAN_CLAWBACK],
+    [
+        'tfMPTSetCanHoldConfidentialBalance',
+        TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE,
+    ],
+    // Inherited from GlobalFlagsInterface.
+    ['tfInnerBatchTxn', 0x40000000],
+]);
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Validate that a boolean-map `Flags` object only contains known keys,
+ * and convert the map into a numeric bitmask for downstream
+ * cross-field gating. Mirrors xrpl.js's `convertTxFlagsToNumber`
+ * (`packages/xrpl/src/models/utils/flags.ts:174–201`) but localized
+ * for MPTokenIssuanceSet.
+ */
+function flagsInterfaceToNumber(flags) {
+    let result = 0;
+    for (const k of Object.keys(flags)) {
+        const bit = VALID_FLAGS_INTERFACE_KEYS.get(k);
+        if (bit === undefined) {
+            throw new ValidationError(`MPTokenIssuanceSet: Flags contains unknown key "${k}"`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- the key set is closed; we narrow per key
+        const v = flags[k];
+        if (v !== undefined && typeof v !== 'boolean') {
+            throw new ValidationError(`MPTokenIssuanceSet: Flags.${k} must be a boolean when present`);
+        }
+        if (v === true) {
+            result |= bit;
+        }
+    }
+    return result;
+}
+/**
+ * Whether the tx is a "field-update" mutation: it sets a mutation
+ * field (TransferFee / MPTokenMetadata / ImmutableFlags / encryption
+ * keys) OR enables a `tfMPTSet*` capability flag.
+ */
+function isMutation(props, flags) {
+    return (props.TransferFee !== undefined ||
+        props.MPTokenMetadata !== undefined ||
+        props.ImmutableFlags !== undefined ||
+        props.IssuerEncryptionKey !== undefined ||
+        props.AuditorEncryptionKey !== undefined ||
+        (flags & TF_MPT_SET_CAPABILITY_MASK) !== 0);
+}
+/**
+ * Whether the tx is registering confidential encryption keys.
+ */
+function isSetConfidentialKeys(props) {
+    return (props.IssuerEncryptionKey !== undefined ||
+        props.AuditorEncryptionKey !== undefined);
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+/**
+ * Build a frozen MPTokenIssuanceSet. 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 mptokenIssuanceSet(props) {
+    // ─── Account ─── required, must be a valid XRPL classic/X-address.
+    require(props.Account, 'MPTokenIssuanceSet: Account is required', isAccount);
+    // ─── MPTokenIssuanceID ─── required, 48-char hex (UINT192), non-zero.
+    if (!isString(props.MPTokenIssuanceID) ||
+        !isHex(props.MPTokenIssuanceID) ||
+        props.MPTokenIssuanceID.length !== MP_TOKEN_ISSUANCE_ID_LENGTH) {
+        throw new ValidationError(`MPTokenIssuanceSet: MPTokenIssuanceID must be a ${MP_TOKEN_ISSUANCE_ID_LENGTH}-character hex string (UINT192)`);
+    }
+    if (/^0+$/u.test(props.MPTokenIssuanceID)) {
+        throw new ValidationError('MPTokenIssuanceSet: MPTokenIssuanceID must not be zero');
+    }
+    // ─── Holder ─── optional, but if present must be a valid XRPL
+    // address AND must differ from `Account` (spec `temMALFORMED`).
+    if (props.Holder !== undefined) {
+        if (!isAccount(props.Holder)) {
+            throw new ValidationError('MPTokenIssuanceSet: Holder is not a valid XRPL address');
+        }
+        if (props.Holder === props.Account) {
+            throw new ValidationError('MPTokenIssuanceSet: Holder must not equal Account (temMALFORMED)');
+        }
+    }
+    // ─── Flags ─── optional, numeric or boolean-map. If boolean-map,
+    // validate the key set AND convert to numeric bits for cross-field
+    // gating.
+    let flags = 0;
+    if (props.Flags !== undefined) {
+        if (isNumber(props.Flags)) {
+            flags = props.Flags;
+        }
+        else if (isRecord(props.Flags)) {
+            flags = flagsInterfaceToNumber(props.Flags);
+        }
+        else {
+            throw new ValidationError('MPTokenIssuanceSet: Flags must be a number or a boolean-map');
+        }
+    }
+    // Per-tx flag bit-mask sanity check (only meaningful for numeric Flags).
+    // The mask already includes the two global flags, so any bit outside
+    // KNOWN_PER_TX_FLAG_BITS is undefined per the spec.
+    if (typeof props.Flags === 'number') {
+        const unknownPerTxBits = props.Flags & ~KNOWN_PER_TX_FLAG_BITS & 0x7fffffff;
+        if (unknownPerTxBits !== 0) {
+            throw new ValidationError(`MPTokenIssuanceSet: Flags contains undefined per-tx bits (0x${unknownPerTxBits.toString(16)})`);
+        }
+    }
+    // ─── DomainID ─── optional 64-char hex; if non-empty and non-"0",
+    // requires tfMPTRequireAuth flag (local proxy for issuance state).
+    if (props.DomainID !== undefined) {
+        if (props.DomainID !== '' && props.DomainID !== '0') {
+            // 64-char hex — the same shape as isDomainID / isLedgerEntryId.
+            if (!isHex(props.DomainID) ||
+                props.DomainID.length !== 64) {
+                throw new ValidationError('MPTokenIssuanceSet: DomainID must be a 64-character hex string (or "" / "0" to clear)');
+            }
+            if ((flags & TF_MPT_SET_REQUIRE_AUTH) === 0) {
+                throw new ValidationError('MPTokenIssuanceSet: DomainID requires tfMPTSetRequireAuth flag (set tfMPTSetRequireAuth in Flags, or enable Require Auth on the issuance first)');
+            }
+        }
+    }
+    // ─── IssuerEncryptionKey / AuditorEncryptionKey ─── optional,
+    // 33-byte compressed EC point (66 hex chars).
+    if (props.IssuerEncryptionKey !== undefined) {
+        if (!isHex(props.IssuerEncryptionKey) ||
+            props.IssuerEncryptionKey.length !== CONFIDENTIAL_EC_POINT_HEX_LENGTH) {
+            throw new ValidationError(`MPTokenIssuanceSet: IssuerEncryptionKey must be a ${CONFIDENTIAL_EC_POINT_HEX_LENGTH}-character hex string (compressed EC point)`);
+        }
+    }
+    if (props.AuditorEncryptionKey !== undefined) {
+        if (!isHex(props.AuditorEncryptionKey) ||
+            props.AuditorEncryptionKey.length !== CONFIDENTIAL_EC_POINT_HEX_LENGTH) {
+            throw new ValidationError(`MPTokenIssuanceSet: AuditorEncryptionKey must be a ${CONFIDENTIAL_EC_POINT_HEX_LENGTH}-character hex string (compressed EC point)`);
+        }
+        if (props.IssuerEncryptionKey === undefined) {
+            throw new ValidationError('MPTokenIssuanceSet: AuditorEncryptionKey requires IssuerEncryptionKey');
+        }
+    }
+    // ─── MPTokenMetadata ─── optional hex. Empty string clears the
+    // field per spec; otherwise 0 < length/2 ≤ MAX_METADATA_BYTES.
+    if (props.MPTokenMetadata !== undefined) {
+        if (!isString(props.MPTokenMetadata)) {
+            throw new ValidationError('MPTokenIssuanceSet: MPTokenMetadata must be a hex string');
+        }
+        if (props.MPTokenMetadata !== '') {
+            if (!isHex(props.MPTokenMetadata) ||
+                props.MPTokenMetadata.length % 2 !== 0) {
+                throw new ValidationError('MPTokenIssuanceSet: MPTokenMetadata must be a hex string (even length when non-empty)');
+            }
+            const lenBytes = props.MPTokenMetadata.length / 2;
+            if (lenBytes > MAX_METADATA_BYTES) {
+                throw new ValidationError(`MPTokenIssuanceSet: MPTokenMetadata length must be ≤ ${MAX_METADATA_BYTES} bytes`);
+            }
+        }
+    }
+    // ─── TransferFee ─── optional UInt16, 0..MAX_TRANSFER_FEE.
+    if (props.TransferFee !== undefined) {
+        if (!isNumber(props.TransferFee) ||
+            !Number.isInteger(props.TransferFee) ||
+            props.TransferFee < 0 ||
+            props.TransferFee > MAX_TRANSFER_FEE) {
+            throw new ValidationError(`MPTokenIssuanceSet: TransferFee must be an integer in [0, ${MAX_TRANSFER_FEE}]`);
+        }
+        // spec temBAD_TRANSFER_FEE: non-zero TransferFee cannot coexist with
+        // tfMPTSetCanHoldConfidentialBalance.
+        if (props.TransferFee > 0 &&
+            (flags & TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE) !== 0) {
+            throw new ValidationError('MPTokenIssuanceSet: non-zero TransferFee cannot combine with tfMPTSetCanHoldConfidentialBalance (temBAD_TRANSFER_FEE)');
+        }
+    }
+    // ─── ImmutableFlags ─── optional, non-zero, known bits only.
+    if (props.ImmutableFlags !== undefined) {
+        if (!isNumber(props.ImmutableFlags) ||
+            !Number.isInteger(props.ImmutableFlags) ||
+            props.ImmutableFlags < 0) {
+            throw new ValidationError('MPTokenIssuanceSet: ImmutableFlags must be a non-negative integer');
+        }
+        if (props.ImmutableFlags === 0) {
+            throw new ValidationError('MPTokenIssuanceSet: ImmutableFlags must be non-zero when present');
+        }
+        if ((props.ImmutableFlags & ~KNOWN_IMMUTABLE_FLAG_BITS) !== 0) {
+            throw new ValidationError('MPTokenIssuanceSet: ImmutableFlags contains undefined bits');
+        }
+    }
+    // ─── Cross-field rules ───
+    // tfMPTLock and tfMPTUnlock are mutually exclusive.
+    const hasLock = (flags & TF_MPT_LOCK) !== 0;
+    const hasUnlock = (flags & TF_MPT_UNLOCK) !== 0;
+    if (hasLock && hasUnlock) {
+        throw new ValidationError('MPTokenIssuanceSet: tfMPTLock and tfMPTUnlock are mutually exclusive');
+    }
+    const mutating = isMutation(props, flags);
+    const setConfidentialKeys = isSetConfidentialKeys(props);
+    // Lock/Unlock cannot combine with field updates or capability-set flags.
+    if ((hasLock || hasUnlock) && mutating) {
+        throw new ValidationError('MPTokenIssuanceSet: lock/unlock flags cannot combine with field updates or capability-setting flags');
+    }
+    // DomainID cannot combine with Holder. Checked first because it is a
+    // specific pairing — surfacing the more specific error helps debugging.
+    if (props.DomainID !== undefined &&
+        props.DomainID !== '' &&
+        props.DomainID !== '0' &&
+        props.Holder !== undefined) {
+        throw new ValidationError('MPTokenIssuanceSet: DomainID and Holder cannot both be set');
+    }
+    // Holder cannot combine with encryption-key registration. Checked
+    // BEFORE the generic "Holder + mutation" rule because it is more
+    // specific — surfacing the more specific error helps debugging.
+    if (props.Holder !== undefined && setConfidentialKeys) {
+        throw new ValidationError('MPTokenIssuanceSet: Holder field is not allowed when registering confidential encryption keys');
+    }
+    // Holder cannot combine with tfMPTSetCanHoldConfidentialBalance
+    // (capability-set flag). Checked BEFORE the generic "Holder +
+    // mutation" rule for the same specificity reason above.
+    if (props.Holder !== undefined &&
+        (flags & TF_MPT_SET_CAN_HOLD_CONFIDENTIAL_BALANCE) !== 0) {
+        throw new ValidationError('MPTokenIssuanceSet: tfMPTSetCanHoldConfidentialBalance cannot combine with Holder');
+    }
+    // Holder cannot combine with mutations.
+    if (props.Holder !== undefined && mutating) {
+        throw new ValidationError('MPTokenIssuanceSet: Holder field is not allowed when mutating MPTokenIssuance');
+    }
+    // ─── Must mutate state ───
+    if (flags === 0 &&
+        (props.DomainID === undefined ||
+            props.DomainID === '' ||
+            props.DomainID === '0') &&
+        !mutating &&
+        !setConfidentialKeys) {
+        throw new ValidationError('MPTokenIssuanceSet: Transaction does not change the state of the MPTokenIssuance ledger object (temMALFORMED)');
+    }
+    return buildFrozenTx('MPTokenIssuanceSet', 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 mptokenIssuanceSet(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=mptoken-issuance-set.js.map

package/dist/fp/factories/mptoken-issuance-set.js.map

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

package/dist/fp/factories/nftoken-accept-offer.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Functional NFTokenAcceptOffer factory — frozen-object style.
+ *
+ * Accepts an existing buy or sell offer for an NFToken, or matches two
+ * complementary offers in brokered mode. Validation happens at
+ * construction; there is no way to construct an invalid tx.
+ *
+ *   import { nftokenAcceptOffer } from 'xrplt/fp';
+ *   // Direct mode — accept a sell offer:
+ *   const tx = nftokenAcceptOffer({ Account, NFTokenSellOffer });
+ *   // Brokered mode — match buy + sell with broker fee:
+ *   const tx2 = nftokenAcceptOffer({
+ *     Account, NFTokenSellOffer, NFTokenBuyOffer, NFTokenBrokerFee: '100',
+ *   });
+ *   const j = tx.toJSON();
+ *   const tx3 = tx.with({ NFTokenBuyOffer: '...' });
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/nftokenacceptoffer
+ * @see https://github.com/XRPLF/xrpl.js/blob/main/packages/xrpl/src/models/transactions/NFTokenAcceptOffer.ts
+ * @see XLS-0020 §1.5.6
+ *     (`~/.mavis/docs.local/xrpl-standards/repo/XLS-0020-non-fungible-tokens/README.md`
+ *     lines 800–834)
+ *
+ * ## Divergences
+ *
+ * Compared with `src/transactions/nftoken-accept-offer.ts`, this factory
+ * adds guards the class skips (or that xrpl.js / xrpl.org / XLS-20
+ * mandate but the class omits):
+ *
+ * - **`NFTokenSellOffer` and `NFTokenBuyOffer` are Hash256** — XLS-20
+ *   §1.5.6 (lines 810, 818) declares both fields as `string` with
+ *   internal type `UINT256`. xrpl.org's `nftokenacceptoffer.md` (lines
+ *   81–82) labels them "String - Hash". A Hash256 is a 64-character
+ *   hexadecimal string. The class accepts any non-empty string via
+ *   `isString`; the factory enforces 64-char hex.
+ *   - Source: XLS-20 §1.5.6 lines 810, 818.
+ *   - Source: xrpl.org `nftokenacceptoffer.md` lines 81–82.
+ *
+ * - **`NFTokenBrokerFee` must be strictly positive (> 0)** — xrpl.js
+ *   `validateNFTokenBrokerFee` (lines 79–83) rejects `value <= 0`. xrpl.org
+ *   error cases (line 100) also call out "it specified a negative
+ *   `NFTokenBrokerFee`" as a `temMALFORMED`. Our class only checks
+ *   `isAmount`, which permits `"0"` and `"-1"`.
+ *   - Source: xrpl.js `NFTokenAcceptOffer.ts` lines 79–83.
+ *   - Source: xrpl.org `nftokenacceptoffer.md` line 100.
+ *
+ * - **`NFTokenBrokerFee` requires brokered mode (both SellOffer AND
+ *   BuyOffer)** — xrpl.js `validateNFTokenBrokerFee` (lines 85–89)
+ *   rejects NFTokenBrokerFee when either SellOffer or BuyOffer is
+ *   missing. XLS-20 §1.5.6 (line 828) explicitly states
+ *   "`NFTokenBrokerFee` ... is only valid in brokered mode." The class
+ *   accepts BrokerFee in direct mode without complaint.
+ *   - Source: xrpl.js `NFTokenAcceptOffer.ts` lines 85–89.
+ *   - Source: XLS-20 §1.5.6 line 828.
+ *
+ * - **IssuedCurrencyAmount `NFTokenBrokerFee` must have a valid issuer
+ *   and a positive base-10 integer value** — our `isAmount` helper
+ *   accepts the structural shape but does not verify the issuer is a
+ *   valid XRPL account or that `value` is a positive base-10 string.
+ *   The factory validates both sub-fields, matching the strictness used
+ *   in `nftokenMint`. We also reject `"XRP"`-currency issued amounts
+ *   (reserved currency code).
+ *   - Source: same hardening applied in `nftoken-mint.ts` Amount
+ *     sub-checks; cf. xrpl.org `nftokenacceptoffer.md` line 101
+ *     (`temBAD_CURRENCY` for reserved `XRP`).
+ *
+ * - **MPTAmount `NFTokenBrokerFee` must have a positive base-10 integer
+ *   value** — same rationale as the IOU branch.
+ *
+ * - **Mode table is encoded as `if/else if` over the 3 valid states**
+ *   (brokered, direct-sell, direct-buy) — XLS-20 §1.5.6 (lines 810–822)
+ *   and xrpl.org `nftokenacceptoffer.md` (lines 47–51) define exactly
+ *   these three modes. The "neither" case is rejected by both xrpl.js
+ *   and the class; the factory adds the positive assertion here for
+ *   clarity in the error message.
+ *   - Source: xrpl.org `nftokenacceptoffer.md` lines 47–51.
+ *   - Source: XLS-20 §1.5.6 lines 810–822.
+ */
+import type { Amount } from '../../types/amounts.js';
+export interface NftokenAcceptOfferProps {
+    /** The transaction submitter (classic or X-address). */
+    Account: string;
+    /**
+     * Direct mode: identifies an existing NFTokenOffer to sell.
+     * Brokered mode: required (XLS-20 §1.5.6).
+     */
+    NFTokenSellOffer?: string | undefined;
+    /**
+     * Direct mode: identifies an existing NFTokenOffer to buy.
+     * Brokered mode: required (XLS-20 §1.5.6).
+     */
+    NFTokenBuyOffer?: string | undefined;
+    /**
+     * Brokered mode only: fee the broker keeps from the buyer's payment.
+     * Must be strictly positive. Requires both SellOffer and BuyOffer.
+     */
+    NFTokenBrokerFee?: Amount | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+}
+export interface NftokenAcceptOffer extends Readonly<NftokenAcceptOfferProps> {
+    readonly TransactionType: 'NFTokenAcceptOffer';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<NftokenAcceptOfferProps>): NftokenAcceptOffer;
+}
+export declare function nftokenAcceptOffer(props: NftokenAcceptOfferProps): NftokenAcceptOffer;
+//# sourceMappingURL=nftoken-accept-offer.d.ts.map

package/dist/fp/factories/nftoken-accept-offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nftoken-accept-offer.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/nftoken-accept-offer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAkBrD,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,kBACf,SAAQ,QAAQ,CAAC,uBAAuB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAC;IAC/C,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,kBAAkB,CAAC;CACvE;AAuED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CAgEpB"}

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

@@ -0,0 +1,105 @@
+import { isAccount, isAmount, isIssuedCurrencyAmount, isMPTAmount, isString, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// XLS-20 §1.5.6 / xrpl.org: NFTokenSellOffer and NFTokenBuyOffer are Hash256.
+const HASH256_LENGTH = 64;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Check that a value is a positive (> 0) base-10 integer string.
+ * The xrpl Amount convention: `value` for IOU/MPT is a non-negative
+ * base-10 string of drops/atomic units; we additionally require > 0 for
+ * NFTokenBrokerFee per xrpl.js's `value <= 0` rejection.
+ */
+function isPositiveAmountString(v) {
+    return isString(v) && /^[0-9]+$/u.test(v) && v !== '0';
+}
+/**
+ * Validate NFTokenBrokerFee shape + strict positive value. Used by the
+ * Amount sub-check guards below.
+ */
+function assertValidBrokerFee(brokerFee) {
+    if (isIssuedCurrencyAmount(brokerFee)) {
+        if (!isAccount(brokerFee.issuer)) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee.issuer must be a valid XRPL account address');
+        }
+        if (brokerFee.currency === 'XRP') {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee must not use the reserved currency code "XRP" (temBAD_CURRENCY)');
+        }
+        if (!isPositiveAmountString(brokerFee.value)) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee IssuedCurrencyAmount.value must be a positive base-10 integer string');
+        }
+    }
+    else if (isMPTAmount(brokerFee)) {
+        if (!isPositiveAmountString(brokerFee.value)) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee MPTAmount.value must be a positive base-10 integer string');
+        }
+    }
+    else if (typeof brokerFee === 'string') {
+        if (!isPositiveAmountString(brokerFee)) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee (XRP drops) must be a positive base-10 integer string');
+        }
+    }
+    else {
+        throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee must be a positive Amount (XRP drops string, IOU object, or MPT object)');
+    }
+}
+/**
+ * Validate an offer hash field (NFTokenSellOffer / NFTokenBuyOffer):
+ * 64-character hex (Hash256 / UInt256).
+ */
+function assertValidOfferHash(field, value) {
+    if (!isString(value) || value.length !== HASH256_LENGTH || !/^[0-9A-Fa-f]+$/u.test(value)) {
+        throw new ValidationError(`NFTokenAcceptOffer: ${field} must be a 64-character hexadecimal string (Hash256)`);
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function nftokenAcceptOffer(props) {
+    // ── Account ── required, must be a valid XRPL classic address.
+    require(props.Account, 'NFTokenAcceptOffer: Account is required', isAccount);
+    // ── Offer fields ── optional, but at least one is required.
+    //    Each, when present, must be a Hash256 (64-char hex).
+    const hasSell = props.NFTokenSellOffer !== undefined;
+    const hasBuy = props.NFTokenBuyOffer !== undefined;
+    if (!hasSell && !hasBuy) {
+        throw new ValidationError('NFTokenAcceptOffer: must have NFTokenSellOffer or NFTokenBuyOffer (direct or brokered mode)');
+    }
+    if (hasSell) {
+        assertValidOfferHash('NFTokenSellOffer', props.NFTokenSellOffer);
+    }
+    if (hasBuy) {
+        assertValidOfferHash('NFTokenBuyOffer', props.NFTokenBuyOffer);
+    }
+    // ── NFTokenBrokerFee ── optional, but brokered-mode-only.
+    //    Must be a positive Amount when present, AND both SellOffer and
+    //    BuyOffer must be set (XLS-20 §1.5.6 line 828).
+    if (props.NFTokenBrokerFee !== undefined) {
+        if (!hasSell || !hasBuy) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee requires both NFTokenSellOffer and NFTokenBuyOffer (brokered mode only)');
+        }
+        if (!isAmount(props.NFTokenBrokerFee)) {
+            throw new ValidationError('NFTokenAcceptOffer: NFTokenBrokerFee must be a valid Amount (XRP drops string, IOU object, or MPT object)');
+        }
+        assertValidBrokerFee(props.NFTokenBrokerFee);
+    }
+    return buildFrozenTx('NFTokenAcceptOffer', 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 nftokenAcceptOffer(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=nftoken-accept-offer.js.map

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

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

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

@@ -0,0 +1,27 @@
+export interface NftokenBurnProps {
+    Account: string;
+    /** The 64-char hex (UInt256) identifier of the NFToken to burn. */
+    NFTokenID: string;
+    /**
+     * (NonFungibleTokensV1_1) The account that currently owns the token,
+     * if different from Account. Used by the issuer / authorized minter
+     * to burn tokens with the `lsfBurnable` flag enabled that are not
+     * owned by the signing account.
+     */
+    Owner?: string | undefined;
+    Fee?: string | undefined;
+    Sequence?: number | undefined;
+    /** Bit-flags (numeric bitmask). NFTokenBurn 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 NftokenBurn extends Readonly<NftokenBurnProps> {
+    readonly TransactionType: 'NFTokenBurn';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<NftokenBurnProps>): NftokenBurn;
+}
+export declare function nftokenBurn(props: NftokenBurnProps): NftokenBurn;
+//# sourceMappingURL=nftoken-burn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nftoken-burn.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/nftoken-burn.ts"],"names":[],"mappings":"AAqFA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,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,WACf,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IAClC,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;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAyDhE"}