xrpjson 0.1.0

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

@@ -0,0 +1,135 @@
+import { isAccount, isHex, isNumber, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// Maximum allowed transfer fee in basis points (0.000% — 50.000%).
+const MAX_TRANSFER_FEE = 50_000;
+// Maximum amount per the current spec (2^63 - 1, encoded as a base-10 string).
+const MAX_ISSUANCE_AMOUNT = '9223372036854775807';
+// Maximum encoded metadata length in bytes.
+const MAX_METADATA_BYTES = 1024;
+// Bitmask of all known `tif*` bits (used to validate `ImmutableFlags`).
+// Mirrors the values defined in `MPTokenImmutableFlags` (src/types/flags.ts).
+const KNOWN_IMMUTABLE_FLAG_BITS = 0x00000002 | // tifMPTCanLock
+    0x00000004 | // tifMPTRequireAuth
+    0x00000008 | // tifMPTCanEscrow
+    0x00000010 | // tifMPTCanTrade
+    0x00000020 | // tifMPTCanTransfer
+    0x00000040 | // tifMPTCanClawback
+    0x00000080 | // tifMPTCanHoldConfidentialBalance
+    0x00010000 | // tifMPTMetadata
+    0x00020000; // tifMPTTransferFee
+// Capable-flag bitmask for `tfMPTCanTransfer` (gates non-zero TransferFee).
+const TF_MPT_CAN_TRANSFER = 0x00000020;
+// Capable-flag bitmask for `tfMPTRequireAuth` (gates DomainID).
+const TF_MPT_REQUIRE_AUTH = 0x00000004;
+// ─── Factory ─────────────────────────────────────────────────────────
+/**
+ * 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 function mptokenIssuanceCreate(props) {
+    // ─── Account ─── required, must be a valid XRPL address (empty
+    // strings and invalid formats fail the regex inside isAccount).
+    require(props.Account, 'MPTokenIssuanceCreate: Account is required', isAccount);
+    // Numeric flags for cross-field gating. When the caller supplies a
+    // boolean-map `Flags` object, we treat it as "no flag bits set" for the
+    // purpose of bitwise checks — same policy as the class version, which
+    // only inspects numeric flags for the gating rules below.
+    const flags = (typeof props.Flags === 'number' ? props.Flags : 0);
+    // ─── TransferFee ───
+    if (props.TransferFee !== undefined) {
+        if (!isNumber(props.TransferFee)) {
+            throw new ValidationError('MPTokenIssuanceCreate: TransferFee must be a number');
+        }
+        if (props.TransferFee < 0 || props.TransferFee > MAX_TRANSFER_FEE) {
+            throw new ValidationError(`MPTokenIssuanceCreate: TransferFee must be in [0, ${MAX_TRANSFER_FEE}]`);
+        }
+        if (props.TransferFee !== 0 && (flags & TF_MPT_CAN_TRANSFER) === 0) {
+            throw new ValidationError('MPTokenIssuanceCreate: non-zero TransferFee requires tfMPTCanTransfer flag');
+        }
+    }
+    // ─── MaximumAmount ───
+    if (props.MaximumAmount !== undefined) {
+        if (!isString(props.MaximumAmount)) {
+            throw new ValidationError('MPTokenIssuanceCreate: MaximumAmount must be a string');
+        }
+        if (props.MaximumAmount === '0') {
+            throw new ValidationError('MPTokenIssuanceCreate: MaximumAmount must be > 0');
+        }
+        // BigInt throws SyntaxError on invalid integer strings; we wrap that
+        // in ValidationError but DO NOT swallow our own out-of-range errors.
+        let n;
+        try {
+            n = BigInt(props.MaximumAmount);
+        }
+        catch (e) {
+            if (e instanceof SyntaxError) {
+                throw new ValidationError('MPTokenIssuanceCreate: MaximumAmount must be a base-10 integer string');
+            }
+            throw e;
+        }
+        const max = BigInt(MAX_ISSUANCE_AMOUNT);
+        if (n > max) {
+            throw new ValidationError(`MPTokenIssuanceCreate: MaximumAmount must be <= ${MAX_ISSUANCE_AMOUNT}`);
+        }
+    }
+    // ─── MPTokenMetadata ───
+    if (props.MPTokenMetadata !== undefined) {
+        if (!isString(props.MPTokenMetadata) || !isHex(props.MPTokenMetadata)) {
+            throw new ValidationError('MPTokenIssuanceCreate: MPTokenMetadata must be a hex string');
+        }
+        const lenBytes = props.MPTokenMetadata.length / 2;
+        if (lenBytes === 0 || lenBytes > MAX_METADATA_BYTES) {
+            throw new ValidationError(`MPTokenIssuanceCreate: MPTokenMetadata length must be in (0, ${MAX_METADATA_BYTES}] bytes`);
+        }
+    }
+    // ─── DomainID ───
+    // The class treats empty string and "0" as "not set" and skips the
+    // flag check in those cases. Mirror that behavior exactly.
+    if (props.DomainID !== undefined &&
+        props.DomainID !== '' &&
+        props.DomainID !== '0') {
+        if ((flags & TF_MPT_REQUIRE_AUTH) === 0) {
+            throw new ValidationError('MPTokenIssuanceCreate: DomainID requires tfMPTRequireAuth flag');
+        }
+    }
+    // ─── ImmutableFlags ───
+    if (props.ImmutableFlags !== undefined) {
+        if (!isNumber(props.ImmutableFlags)) {
+            throw new ValidationError('MPTokenIssuanceCreate: ImmutableFlags must be a number');
+        }
+        if (props.ImmutableFlags === 0) {
+            throw new ValidationError('MPTokenIssuanceCreate: ImmutableFlags must be non-zero when present');
+        }
+        if ((props.ImmutableFlags & ~KNOWN_IMMUTABLE_FLAG_BITS) !== 0) {
+            throw new ValidationError('MPTokenIssuanceCreate: ImmutableFlags contains undefined bits');
+        }
+    }
+    // ─── Build frozen shape ───
+    return buildFrozenTx('MPTokenIssuanceCreate', 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 mptokenIssuanceCreate(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=mptoken-issuance-create.js.map

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

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

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

@@ -0,0 +1,32 @@
+export interface MptokenIssuanceDestroyProps {
+    /** The unique address of the transaction sender (must be the MPT issuer). */
+    Account: string;
+    /**
+     * The id of the MPTokenIssuance ledger entry to remove. UINT192 —
+     * exactly 48 hex chars; must not be all-zero.
+     */
+    MPTokenIssuanceID: string;
+    /** Bit-flags for this transaction. The spec defines none — must be 0. */
+    Flags?: number | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface MptokenIssuanceDestroy extends Readonly<MptokenIssuanceDestroyProps> {
+    readonly TransactionType: 'MPTokenIssuanceDestroy';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<MptokenIssuanceDestroyProps>): MptokenIssuanceDestroy;
+}
+/**
+ * Build a frozen MPTokenIssuanceDestroy. 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 mptokenIssuanceDestroy(props: MptokenIssuanceDestroyProps): MptokenIssuanceDestroy;
+//# sourceMappingURL=mptoken-issuance-destroy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-issuance-destroy.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-issuance-destroy.ts"],"names":[],"mappings":"AAmEA,MAAM,WAAW,2BAA2B;IAC1C,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,sBACf,SAAQ,QAAQ,CAAC,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAC;IACnD,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAAG,sBAAsB,CAAC;CAC/E;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,sBAAsB,CAgDxB"}

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

@@ -0,0 +1,105 @@
+/**
+ * Functional MPTokenIssuanceDestroy factory — frozen-object style.
+ *
+ * Permanently removes an MPTokenIssuance ledger entry. Only the issuer
+ * of the MPT can submit this transaction, and only if no holders have
+ * non-zero balances. Validation happens at construction; there is no
+ * way to construct an invalid tx.
+ *
+ *   import { mptokenIssuanceDestroy } from 'xrplt/fp';
+ *   const tx = mptokenIssuanceDestroy({ Account, MPTokenIssuanceID });
+ *   const j = tx.toJSON();
+ *
+ * Affected amendments:
+ *   - `MPTokensV1` — base MPTokenIssuanceDestroy.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/mptokenissuancedestroy
+ * @see XLS-0033 §3.2 (Transaction: `MPTokenIssuanceDestroy`)
+ *      in `~/.mavis/docs.local/xrpl-standards/repo/XLS-0033-multi-purpose-tokens/README.md`
+ * @see ripple-binary-codec `definitions.json`:
+ *      `MPTokenIssuanceDestroy: [ { name: "MPTokenIssuanceID", optionality: 0 } ]`
+ *      (transaction type id 55; only required field is `MPTokenIssuanceID`).
+ *
+ * ## Divergences
+ *
+ * The factory enforces three preclaim checks that the class API
+ * (`src/transactions/mptoken-issuance-destroy.ts`) and xrpl.js both skip:
+ *
+ *   1. `MPTokenIssuanceID` must be a 48-character hex string (24 bytes /
+ *      UINT192). The class only calls `isString(this.MPTokenIssuanceID)`,
+ *      so any string passes — including malformed or wrong-length values.
+ *      The ripple-binary-codec serializer requires exactly 24 bytes.
+ *      Source: XLS-0033 §3.2.1 (`MPTokenIssuanceID` — `UINT192`);
+ *              ripple-binary-codec `definitions.json`
+ *              (`MPTokenIssuanceDestroy` field schema).
+ *
+ *   2. `MPTokenIssuanceID` must NOT be the all-zeros UINT192 value.
+ *      A 48-char string of zeros would otherwise pass the hex+length
+ *      check. The spec does not assign ledger entries an all-zero id;
+ *      rippled would reject this with `temMALFORMED` at submit time.
+ *      Source: XLS-0033 §2.1.1.1 (MPTokenIssuanceID derivation —
+ *              contains a 4-byte sequence plus a 20-byte AccountID, so
+ *              an all-zero value cannot be a valid issuance id);
+ *              analogue with XLS-66 §3.4.3.1 (HASH256 zero rejection).
+ *
+ *   3. `Account` is validated as a classic/X-address via `isAccount`,
+ *      not just as a non-empty string. The class API delegates Account
+ *      checking to the base class's `validateBaseTransaction`, which
+ *      only requires `typeof Account === 'string'`. The factory is
+ *      consistent with other MPT factories (`mptokenIssuanceCreate`,
+ *      `loanBrokerDelete`).
+ *      Source: `src/validation/base.ts` (validateBaseTransaction —
+ *              only `isString(Account)`); `src/fp/factories/
+ *              mptoken-issuance-create.ts` precedent.
+ */
+import { isAccount, isHex, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// UINT192 = 192 bits = 24 bytes = 48 hex chars.
+const MP_TOKEN_ISSUANCE_ID_LENGTH = 48;
+// All-zeros UINT192 — never a valid MPTokenIssuanceID.
+const MP_TOKEN_ISSUANCE_ID_ZERO = '0'.repeat(MP_TOKEN_ISSUANCE_ID_LENGTH);
+// ─── Factory ─────────────────────────────────────────────────────────
+/**
+ * Build a frozen MPTokenIssuanceDestroy. 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 mptokenIssuanceDestroy(props) {
+    // ── Account ── required, must be a valid XRPL classic or X-address.
+    require(props.Account, 'MPTokenIssuanceDestroy: 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(`MPTokenIssuanceDestroy: MPTokenIssuanceID must be a ${MP_TOKEN_ISSUANCE_ID_LENGTH}-character hex string (UINT192)`);
+    }
+    if (props.MPTokenIssuanceID === MP_TOKEN_ISSUANCE_ID_ZERO) {
+        throw new ValidationError('MPTokenIssuanceDestroy: MPTokenIssuanceID must not be zero');
+    }
+    return buildFrozenTx('MPTokenIssuanceDestroy', 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 mptokenIssuanceDestroy(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=mptoken-issuance-destroy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-issuance-destroy.js","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-issuance-destroy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,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,gDAAgD;AAChD,MAAM,2BAA2B,GAAG,EAAE,CAAC;AACvC,uDAAuD;AACvD,MAAM,yBAAyB,GAAG,GAAG,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;AA4B1E,wEAAwE;AAExE;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAkC;IAElC,qEAAqE;IACrE,OAAO,CACL,KAAK,CAAC,OAAO,EACb,6CAA6C,EAC7C,SAAS,CACV,CAAC;IAEF,qEAAqE;IACrE,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,uDAAuD,2BAA2B,iCAAiC,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,KAAK,yBAAyB,EAAE,CAAC;QAC1D,MAAM,IAAI,eAAe,CACvB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAClB,wBAAwB,EACxB,KAAK,EACL;QACE,QAAQ;YACN,6BAA6B;QAC/B,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,SAA+C;YAE/C,OAAO,sBAAsB,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC/D,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,196 @@
+/**
+ * Functional MPTokenIssuanceSet factory — frozen-object style.
+ *
+ * Updates the mutable properties of an existing Multi-Purpose Token
+ * (MPT) issuance. Supports per-holder or global lock/unlock, capability
+ * flag enabling (`tfMPTSet*`), field updates (TransferFee,
+ * MPTokenMetadata, ImmutableFlags, encryption keys), and DomainID
+ * binding. Validation happens at construction; there is no way to
+ * construct an invalid tx.
+ *
+ *   import { mptokenIssuanceSet } from 'xrplt/fp';
+ *   const tx = mptokenIssuanceSet({
+ *     Account: ISSUER,
+ *     MPTokenIssuanceID,
+ *     Flags: { tfMPTLock: true },
+ *   });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ TransferFee: 50 });
+ *
+ * Affected amendments:
+ *   - `MPTokensV1`        — base transaction.
+ *   - `DynamicMPT`        — adds TransferFee / MPTokenMetadata /
+ *                            ImmutableFlags / `tfMPTSet*` capability flags.
+ *   - `PermissionedDomains + SingleAssetVault` — adds `DomainID`.
+ *   - `ConfidentialTransfer` — adds encryption keys +
+ *                              `tfMPTSetCanHoldConfidentialBalance`.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/mptokenissuanceset
+ * @see XLS-0033 §3.3 (MPTokenIssuanceSet Transaction)
+ *      in `~/.mavis/docs.local/xrpl-standards/repo/XLS-0033-multi-purpose-tokens/README.md`
+ *
+ * ## Divergences
+ *
+ * The class-based API at `src/transactions/mptoken-issuance-set.ts` and
+ * xrpl.js's `validateMPTokenIssuanceSet` are missing seven rules that
+ * the canonical sources require. The factory fills them:
+ *
+ *   1. `Account` is validated as a classic/X-address via `isAccount`.
+ *      The class delegates Account validation to its `Transaction`
+ *      base, which only requires `typeof === 'string'`. A malformed
+ *      Account passes class validation and only fails at submit time
+ *      with `temINVALID_ACCOUNT`. The factory validates the format at
+ *      construction.
+ *      Source: xrpl.js `validateBaseTransaction`
+ *              (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/common.ts:987`)
+ *              — only `isString(Account)`.
+ *      Source: local `isAccount` at `src/validation/helpers.ts:55–60`.
+ *
+ *   2. `MPTokenIssuanceID` must be a 48-character hex `UInt192`, and
+ *      must not be all-zero. xrpl.js only checks `isString`; the class
+ *      only checks `isString`. Wrong-length, non-hex, and all-zero
+ *      values all pass.
+ *      Source: XLS-0033 §3.3.1 (`MPTokenIssuanceID` Internal Type:
+ *              `UINT192`); ripple-binary-codec `definitions.json`
+ *              (`~/.mavis/docs.local/xrpl.js/repo/packages/ripple-binary-codec/src/enums/definitions.json`)
+ *              line 6093–6125 (`MPTokenIssuanceID` declared required
+ *              for `MPTokenIssuanceSet`).
+ *
+ *   3. `Holder` must differ from `Account`.
+ *      xrpl.js `validateMPTokenIssuanceSet` (lines 245–249) throws on
+ *      this; the class does not. The spec Error Cases table lists
+ *      `temMALFORMED` — "You specified the same account for both
+ *      `Account` and `Holder`" — so we treat this as a hard guard.
+ *      Source: xrpl-dev-portal `mptokenissuanceset.md`
+ *              (`~/.mavis/docs.local/xrpl-dev-portal/repo/docs/references/protocol/transactions/types/mptokenissuanceset.md`)
+ *              Error Cases — `temMALFORMED` clause "same account for
+ *              both `Account` and `Holder`".
+ *
+ *   4. `tfMPTLock` and `tfMPTUnlock` cannot coexist with non-zero
+ *      `TransferFee` combined with `tfMPTSetCanHoldConfidentialBalance`.
+ *      The class only checks Lock/Unlock mutual exclusivity plus a
+ *      loose field-update incompatibility; it does NOT enforce the
+ *      `temBAD_TRANSFER_FEE` pairing "non-zero TransferFee together
+ *      with `tfMPTSetCanHoldConfidentialBalance`".
+ *      Source: xrpl-dev-portal `mptokenissuanceset.md` Error Cases —
+ *              `temBAD_TRANSFER_FEE` clause "A non-zero `TransferFee`
+ *              is set in the same transaction that enables
+ *              confidential balances with
+ *              `tfMPTSetCanHoldConfidentialBalance`".
+ *      Source: xrpl.js `validateMPTokenIssuanceSet` (lines 299–311) —
+ *              throws `MPTokenIssuanceSet: TransferFee cannot be
+ *              provided together with the
+ *              tfMPTSetCanHoldConfidentialBalance flag`.
+ *
+ *   5. The transaction must actually mutate state.
+ *      If no flags are set AND `DomainID` is absent AND no mutation
+ *      field is present AND no encryption keys are set, the tx is a
+ *      no-op and should be rejected with `temMALFORMED` per the spec.
+ *      The class does not enforce this — the empty `MPTokenIssuanceSet`
+ *      passes class validation.
+ *      Source: xrpl-dev-portal `mptokenissuanceset.md` Error Cases —
+ *              `temMALFORMED` clause "The transaction isn't changing
+ *              anything; it must either update a flag or modify the
+ *              DomainID."
+ *      Source: xrpl.js `validateMPTokenIssuanceSet` (lines 261–270) —
+ *              throws when `flagsNum === 0 && DomainID == null &&
+ *              !isMutate && !isSetConfidentialKeys`.
+ *
+ *   6. Encryption key field-pairing with `IssuerEncryptionKey`.
+ *      The class checks "Auditor requires Issuer" but does NOT enforce
+ *      that both encryption keys are 33-byte (66 hex-char) compressed
+ *      EC points. xrpl.js uses `isHexWithByteLength(CONFIDENTIAL_EC_POINT_BYTES)`
+ *      (lines 195–203). Malformed keys would only fail at submit time.
+ *      The factory enforces both the pair rule AND the byte-length
+ *      shape.
+ *      Source: xrpl.js `validateMPTokenIssuanceSet` (lines 195–208);
+ *              xrpl.js `common.ts:35` — `CONFIDENTIAL_EC_POINT_BYTES = 33`;
+ *              xrpl-dev-portal `mptokenissuanceset.md` Error Cases —
+ *              `temMALFORMED` clause "The `IssuerEncryptionKey` or
+ *              `AuditorEncryptionKey` is not a valid 33-byte compressed
+ *              public key".
+ *
+ *   7. The `Flags` boolean-map shape is validated.
+ *      The class's `MPTokenIssuanceSetFlagsInterface` documents the
+ *      allowed set, but neither the class nor xrpl.js's
+ *      `validateMPTokenIssuanceSet` rejects unknown boolean keys (e.g.
+ *      `tfNotARealFlag: true`). The factory checks every key on a
+ *      boolean-map `Flags` against the closed set of known flags.
+ *      Source: xrpl.js `MPTokenIssuanceSetFlagsInterface`
+ *              (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/transactions/MPTokenIssuanceSet.ts`)
+ *              lines 100–123.
+ */
+import type { MPTokenIssuanceSetFlagsInterface } from '../../types/flags.js';
+export interface MptokenIssuanceSetProps {
+    /** The issuer of the MPT issuance (the transaction sender). */
+    Account: string;
+    /** The ID of the MPTokenIssuance to update. UINT192 (24 bytes / 48 hex chars). */
+    MPTokenIssuanceID: string;
+    /**
+     * Optional holder address. If omitted, the operation applies globally
+     * to all holders of the issuance. Cannot be the same as `Account`.
+     */
+    Holder?: string | undefined;
+    /**
+     * Optional 64-char hex permissioned domain ID. Empty string / '0'
+     * clears the domain. Requires `tfMPTRequireAuth` flag on this tx
+     * (a local proxy for the issuance's existing flag state).
+     */
+    DomainID?: string | undefined;
+    /**
+     * Issuer's 33-byte compressed EC-ElGamal public key (66 hex chars).
+     * Required (when `ConfidentialTransfer` is active) to register the
+     * issuer for confidential transfers.
+     */
+    IssuerEncryptionKey?: string | undefined;
+    /**
+     * Optional auditor's 33-byte compressed EC-ElGamal public key (66 hex
+     * chars). Requires `IssuerEncryptionKey` to be set in the same tx.
+     */
+    AuditorEncryptionKey?: string | undefined;
+    /**
+     * New metadata in hex format. Replaces the existing value. Setting an
+     * empty string (`''`) clears the field; otherwise 0 < length/2 ≤ 1024.
+     */
+    MPTokenMetadata?: string | undefined;
+    /**
+     * New transfer fee in basis points. UInt16 per spec (0..50000).
+     * Setting to zero clears the field.
+     */
+    TransferFee?: number | undefined;
+    /**
+     * Bitmask declaring which fields / capability flags become immutable.
+     * Non-zero when present; uses only known `tif*` bits.
+     */
+    ImmutableFlags?: number | undefined;
+    /**
+     * Optional bit-flags. Either a numeric bitmask or a boolean-map
+     * shape. When a map is supplied, keys must be a member of the closed
+     * set defined by `MPTokenIssuanceSetFlagsInterface`.
+     */
+    Flags?: number | MPTokenIssuanceSetFlagsInterface | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface MptokenIssuanceSet extends Readonly<MptokenIssuanceSetProps> {
+    readonly TransactionType: 'MPTokenIssuanceSet';
+    /** 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 MptokenIssuanceSet with overrides applied; re-validates. */
+    with(overrides: Partial<MptokenIssuanceSetProps>): MptokenIssuanceSet;
+}
+/**
+ * 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 declare function mptokenIssuanceSet(props: MptokenIssuanceSetProps): MptokenIssuanceSet;
+//# sourceMappingURL=mptoken-issuance-set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mptoken-issuance-set.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/mptoken-issuance-set.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyHG;AACH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAuG7E,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,gCAAgC,GAAG,SAAS,CAAC;IAC9D,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,kBACf,SAAQ,QAAQ,CAAC,uBAAuB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAC;IAC/C,0DAA0D;IAC1D,QAAQ,IAAI,IAAI,CAAC;IACjB,kEAAkE;IAClE,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,4EAA4E;IAC5E,IAAI,CACF,SAAS,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC1C,kBAAkB,CAAC;CACvB;AAqED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAC7B,kBAAkB,CAiSpB"}