xrpjson 0.1.0

package/dist/fp/factories/credential-create.js

@@ -0,0 +1,204 @@
+/**
+ * Functional CredentialCreate factory — frozen-object style.
+ *
+ * Provisionally issues a credential to a `Subject` account. The credential
+ * is not valid until the subject accepts it with a `CredentialAccept`.
+ * Validation happens at construction; there is no way to construct an
+ * invalid tx.
+ *
+ *   import { credentialCreate } from 'xrplt/fp';
+ *   const tx = credentialCreate({
+ *     Account: issuerAddr,
+ *     Subject: subjectAddr,
+ *     CredentialType: '6D795F63726564656E7469616C',
+ *   });
+ *   const j = tx.toJSON();
+ *   const tx2 = tx.with({ Expiration: 1735689600 });
+ *
+ * Required amendment: `Credentials`.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/credentialcreate
+ * @see https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0070-credentials
+ *
+ * ## Divergences
+ *
+ * The class-based API at `src/transactions/credential-create.ts` is
+ * missing several rules the canonical sources require AND exposes one
+ * field that is not in the spec at all. The factory corrects both:
+ *
+ *   1. `CredentialSequence` is NOT in the spec.
+ *      The class exposes `CredentialSequence: number` as a required
+ *      field. XLS-0070 §3.1 lists ONLY `TransactionType`, `Account`,
+ *      `Subject`, `CredentialType`, `Expiration`, `URI`. xrpl.js
+ *      5.3.0 `models/transactions/CredentialCreate.ts` and xrpl-dev-portal
+ *      `credentialcreate.md` agree: no `CredentialSequence`. The
+ *      `Credential` ledger object's `CredentialSequence` is auto-assigned
+ *      by the network (XLS-0070 §3.3), not by the issuer. The factory
+ *      omits this field entirely.
+ *      Source: XLS-0070 §3.1 (field table) and §3.3 (state changes);
+ *              xrpl.js `models/transactions/CredentialCreate.ts`
+ *              lines 22–39; xrpl-dev-portal
+ *              `credentialcreate.md` (field table).
+ *
+ *   2. `CredentialType` must be a non-empty hex string ≤ 64 bytes.
+ *      The class only checks `isString`. XLS-0070 §3.2 failure
+ *      conditions: "The `CredentialType` field is empty or too long
+ *      (limit 64 bytes)." XLS-0070 §2.1.3 also says: "It has a maximum
+ *      length of 64 bytes, and cannot be an empty string." xrpl.js
+ *      enforces the same with `MAX_CREDENTIAL_TYPE_LENGTH = 128`
+ *      (hex chars for 64 bytes) and a hex regex.
+ *      Source: XLS-0070 §3.2 + §2.1.3; xrpl.js
+ *              `models/transactions/common.ts:29–30` (`MAX_CREDENTIAL_TYPE_LENGTH`),
+ *              `models/transactions/common.ts:1061–1093`
+ *              (`validateCredentialType`).
+ *
+ *   3. `URI` must be a non-empty hex string ≤ 256 bytes.
+ *      The class only checks it is undefined-or-string. XLS-0070 §3.2
+ *      failure: "The `URI` field is empty or too long (limit 256
+ *      bytes)." The factory enforces ≤ 512 hex chars (256 bytes),
+ *      matching the spec — NOT the more conservative 256-hex-char cap
+ *      that xrpl.js 5.3.0 enforces at `CredentialCreate.ts:15`
+ *      (`MAX_URI_LENGTH = 256` actually bounds the hex string to 256
+ *      characters = 128 bytes; this is an xrpl.js under-spec limit that
+ *      the factory intentionally does NOT mirror).
+ *      Source: XLS-0070 §3.2 + §2.1.2 (`MaxCredentialUriBytes = 256`);
+ *              xrpl-dev-portal `credentialcreate.md` (URI table row:
+ *              "maximum is 256 bytes").
+ *
+ *   4. `Expiration` must be a positive integer in UInt32 range.
+ *      The class only checks `isNumber`. XLS-0070 §3.1 lists
+ *      `Expiration` as `UInt32`. The factory enforces `Expiration`
+ *      to be a finite, non-negative integer ≤ 2^32 − 1. (Whether the
+ *      time is in the future is a runtime check, not enforceable here.)
+ *      Source: XLS-0070 §3.1 (Internal Type column = UInt32);
+ *              XLS-0070 §3.2 failure "The time in Expiration is in the
+ *              past".
+ *
+ *   5. `Subject` must not be ACCOUNT_ZERO (`rHb9CJAWyB4rj91VRWn96Dkukn4MRtfQ`).
+ *      The class accepts any `isAccount`-shaped string. xrpl-dev-portal
+ *      `credentialcreate.md` error cases lists `temINVALID_ACCOUNT_ID`
+ *      fired "if it contains ACCOUNT_ZERO". The factory rejects the
+ *      zero address explicitly.
+ *      Source: xrpl-dev-portal `credentialcreate.md` (Error Cases
+ *              table, row for `temINVALID_ACCOUNT_ID`).
+ *
+ *   6. `Account` must be a non-empty string.
+ *      The class uses `isAccount` which allows empty strings to slip
+ *      through the format regex's lower bound (24+ chars), so an empty
+ *      Account would actually be caught — but only as a side effect of
+ *      length. The factory makes the intent explicit.
+ *      Source: XLS-0070 §3.1 (Account is required, type AccountID);
+ *              xrpl.js `validateCredentialCreate` calls
+ *              `validateRequiredField(tx, 'Account', isString)`.
+ */
+import { isAccount, isHex, isNumber, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+/** CredentialType max bytes (XLS-0070 §3.2). */
+const MAX_CREDENTIAL_TYPE_BYTES = 64;
+/** CredentialType max hex chars = 2 × bytes. */
+const MAX_CREDENTIAL_TYPE_LENGTH = MAX_CREDENTIAL_TYPE_BYTES * 2;
+/** URI max bytes (XLS-0070 §3.2). */
+const MAX_URI_BYTES = 256;
+/** URI max hex chars = 2 × bytes. */
+const MAX_URI_LENGTH = MAX_URI_BYTES * 2;
+/** UInt32 max. */
+const UINT32_MAX = 0xffffffff;
+/** The XRPL ACCOUNT_ZERO address; rippled rejects this as Subject. */
+const ACCOUNT_ZERO = 'rHb9CJAWyB4rj91VRWn96Dkukn4MRtfQ';
+// ─── Helpers ─────────────────────────────────────────────────────────
+function validateCredentialType(value) {
+    if (!isString(value)) {
+        throw new ValidationError('CredentialCreate: CredentialType must be a hex string');
+    }
+    if (value.length === 0) {
+        throw new ValidationError('CredentialCreate: CredentialType cannot be an empty string');
+    }
+    if (!isHex(value)) {
+        throw new ValidationError('CredentialCreate: CredentialType must be encoded in hex');
+    }
+    if (value.length % 2 !== 0) {
+        throw new ValidationError('CredentialCreate: CredentialType must be a hex string with an even number of characters');
+    }
+    if (value.length > MAX_CREDENTIAL_TYPE_LENGTH) {
+        throw new ValidationError(`CredentialCreate: CredentialType length must be <= ${MAX_CREDENTIAL_TYPE_LENGTH} hex chars (${MAX_CREDENTIAL_TYPE_BYTES} bytes)`);
+    }
+    return value;
+}
+function validateURI(value) {
+    if (!isString(value)) {
+        throw new ValidationError('CredentialCreate: URI must be a hex string');
+    }
+    if (value.length === 0) {
+        throw new ValidationError('CredentialCreate: URI cannot be an empty string');
+    }
+    if (!isHex(value)) {
+        throw new ValidationError('CredentialCreate: URI must be encoded in hex');
+    }
+    if (value.length > MAX_URI_LENGTH) {
+        throw new ValidationError(`CredentialCreate: URI length must be <= ${MAX_URI_LENGTH} hex chars (${MAX_URI_BYTES} bytes)`);
+    }
+    return value;
+}
+function validateExpiration(value) {
+    if (!isNumber(value) || !Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new ValidationError('CredentialCreate: Expiration must be an integer');
+    }
+    if (value < 0) {
+        throw new ValidationError('CredentialCreate: Expiration must be non-negative');
+    }
+    if (value > UINT32_MAX) {
+        throw new ValidationError(`CredentialCreate: Expiration must fit in UInt32 (max ${UINT32_MAX})`);
+    }
+    return value;
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function credentialCreate(props) {
+    // ── Account ── required, must be a non-empty string.
+    require(props.Account, 'CredentialCreate: Account is required', isString);
+    if (props.Account.length === 0) {
+        throw new ValidationError('CredentialCreate: Account is required');
+    }
+    // ── Subject ── required, must be a valid XRPL account AND not ACCOUNT_ZERO.
+    require(props.Subject, 'CredentialCreate: Subject is required', isString);
+    if (props.Subject.length === 0) {
+        throw new ValidationError('CredentialCreate: Subject is required');
+    }
+    if (!isAccount(props.Subject)) {
+        throw new ValidationError('CredentialCreate: Subject must be a valid XRPL address');
+    }
+    if (props.Subject === ACCOUNT_ZERO) {
+        throw new ValidationError('CredentialCreate: Subject must not be ACCOUNT_ZERO');
+    }
+    // ── CredentialType ── required, hex, 1–64 bytes.
+    validateCredentialType(props.CredentialType);
+    // ── URI ── optional, hex, 1–256 bytes when present.
+    if (props.URI !== undefined) {
+        validateURI(props.URI);
+    }
+    // ── Expiration ── optional, finite UInt32 integer.
+    if (props.Expiration !== undefined) {
+        validateExpiration(props.Expiration);
+    }
+    return buildFrozenTx('CredentialCreate', 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 credentialCreate(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=credential-create.js.map

package/dist/fp/factories/credential-create.js.map

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

package/dist/fp/factories/credential-delete.d.ts

@@ -0,0 +1,33 @@
+export interface CredentialDeleteProps {
+    /** The unique address of the transaction sender. */
+    Account: string;
+    /**
+     * The subject of the credential to delete.
+     * If omitted, `Account` is assumed to be the subject.
+     * At least one of `Subject` / `Issuer` must be provided (XLS-0070 §5.1).
+     */
+    Subject?: string | undefined;
+    /**
+     * The issuer of the credential to delete.
+     * If omitted, `Account` is assumed to be the issuer.
+     * At least one of `Subject` / `Issuer` must be provided (XLS-0070 §5.1).
+     */
+    Issuer?: string | undefined;
+    /**
+     * Hex-encoded credential type (Blob). 1–128 hex chars (1–64 bytes).
+     * Cannot be empty (XLS-0070 §2.1.3).
+     */
+    CredentialType: string;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface CredentialDelete extends Readonly<CredentialDeleteProps> {
+    readonly TransactionType: 'CredentialDelete';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<CredentialDeleteProps>): CredentialDelete;
+}
+export declare function credentialDelete(props: CredentialDeleteProps): CredentialDelete;
+//# sourceMappingURL=credential-delete.d.ts.map

package/dist/fp/factories/credential-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-delete.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/credential-delete.ts"],"names":[],"mappings":"AAsHA,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,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,gBAAiB,SAAQ,QAAQ,CAAC,qBAAqB,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,gBAAgB,CAAC;CACnE;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CA2E/E"}

package/dist/fp/factories/credential-delete.js

@@ -0,0 +1,167 @@
+/**
+ * Functional CredentialDelete factory — frozen-object style.
+ *
+ * Deletes a `Credential` ledger entry. The holder or the issuer may
+ * submit this transaction. Validation happens at construction; there is
+ * no way to construct an invalid tx.
+ *
+ *   import { credentialDelete } from 'xrplt/fp';
+ *   const tx = credentialDelete({ Account, Subject, CredentialType });
+ *   const j = tx.toJSON();
+ *
+ * Affected amendments:
+ *   - `Credentials` — base CredentialDelete (XLS-0070 §5).
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/credentialdelete
+ * @see XLS-0070 §5 (Transaction: `CredentialDelete`) in
+ *      `~/.mavis/docs.local/xrpl-standards/repo/XLS-0070-credentials/README.md`
+ *
+ * ## Divergences
+ *
+ * The class-based API at `src/transactions/credential-delete.ts` and
+ * xrpl.js's `validateCredentialDelete` both diverge from the XLS-0070
+ * spec on two rules. The factory fills both gaps.
+ *
+ *   1. `Subject` and `Issuer` are OPTIONAL — at least one is required.
+ *
+ *      Per XLS-0070 §5.1, both `Subject` and `Issuer` are listed as
+ *      not-required ("If omitted, `Account` is assumed to be the
+ *      subject / issuer"). The note immediately below the field table
+ *      states: "If an account is deleting a credential it issued to
+ *      itself, then either `Subject` or `Issuer` can be specified, but
+ *      at least one must be."
+ *
+ *      xrpl.js implements this correctly
+ *      (`validateCredentialDelete` in
+ *       `~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/
+ *       transactions/CredentialDelete.ts`, lines 39–55 — throws
+ *       "either `Issuer` or `Subject` must be provided" when both are
+ *       absent).
+ *
+ *      The local class API is wrong on this point: it declares
+ *      `Subject` and `Issuer` as `readonly Subject: string` /
+ *      `readonly Issuer: string` (both required) and rejects any tx
+ *      that omits one with "missing or invalid Subject/Issuer". A tx
+ *      with `Account === Issuer === Subject` (deleting a self-issued
+ *      credential) cannot be constructed via the class. The factory
+ *      makes both optional and enforces "at least one of {Subject,
+ *      Issuer}".
+ *
+ *      Source citation:
+ *        - XLS-0070 §5.1 + §5.2 in
+ *          `~/.mavis/docs.local/xrpl-standards/repo/XLS-0070-credentials/
+ *          README.md` (lines 199–212).
+ *        - xrpl.js `validateCredentialDelete` at
+ *          `~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/
+ *          transactions/CredentialDelete.ts` (lines 39–55).
+ *        - xrpl-dev-portal `credentialdelete.md`
+ *          (`~/.mavis/docs.local/xrpl-dev-portal/repo/docs/references/
+ *          protocol/transactions/types/credentialdelete.md`): "You
+ *          must provide the `Subject` field, `Issuer` field, or both."
+ *        - Local class at `src/transactions/credential-delete.ts`
+ *          (lines 9–17 and 37–38 — both declared required and both
+ *          validated as required).
+ *
+ *   2. `CredentialType` is a hex `Blob`, not just any string.
+ *
+ *      Per XLS-0070 §2.1.3 (the field definition carried over into the
+ *      CredentialDelete spec): "It has a maximum length of 64 bytes,
+ *      and cannot be an empty string." In hex that is 1–128
+ *      characters. xrpl.js's `validateCredentialType` enforces this
+ *      (`~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/
+ *      transactions/common.ts`, lines 1061–1093 — checks
+ *      `MAX_CREDENTIAL_BYTE_LENGTH = 64`, empty-string rejection, and
+ *      `HEX_REGEX`).
+ *
+ *      The local class API only checks `isString(this.CredentialType)`
+ *      (line 39). That admits three classes of bad input that rippled
+ *      will reject: empty string (too short), non-hex strings, and
+ *      strings longer than 128 hex chars. The factory rejects all
+ *      three at construction.
+ *
+ *      Source citation:
+ *        - XLS-0070 §2.1.3 in
+ *          `~/.mavis/docs.local/xrpl-standards/repo/XLS-0070-credentials/
+ *          README.md` (line 116: "It has a maximum length of 64
+ *          bytes, and cannot be an empty string.").
+ *        - xrpl.js `validateCredentialType` at
+ *          `~/.mavis/docs.local/xrpl.js/repo/packages/xrpl/src/models/
+ *          transactions/common.ts` (lines 1061–1093 — empty-string,
+ *          length ≤ 128 hex chars, `HEX_REGEX`).
+ *        - xrpl-dev-portal `credentialdelete.md` (line 34): "The
+ *          minimum length is 1 byte and the maximum length is 256
+ *          bytes." (Note: the portal's "256 bytes" appears to be a
+ *          copy-paste error from the `URI` field table; XLS-0070
+ *          §2.1.3 and xrpl.js both cap at 64 bytes / 128 hex chars.
+ *          The factory follows the standard + xrpl.js.)
+ *        - Local class at `src/transactions/credential-delete.ts`
+ *          (line 39 — only `isString`).
+ *
+ * The factory also validates `Account` as a well-formed XRPL
+ * classic/X-address. This matches the pattern in every other fp factory
+ * (`vaultDelete`, `permissionedDomainDelete`, `loanBrokerDelete`, …)
+ * and matches xrpl.js's `validateBaseTransaction` (which calls
+ * `validateRequiredField(common, 'Account', isString)` against the
+ * same regex). The class API here uses only `isString` via
+ * `validateBaseTransaction`.
+ */
+import { isAccount, isHex, isString } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// XLS-0070 §2.1.3 + xrpl.js MAX_CREDENTIAL_BYTE_LENGTH (= 64) → 128 hex chars.
+const MAX_CREDENTIAL_TYPE_HEX_LENGTH = 128;
+// ─── Factory ─────────────────────────────────────────────────────────
+export function credentialDelete(props) {
+    // ── Account ── required, must be a valid XRPL classic or X-address.
+    require(props.Account, 'CredentialDelete: Account is required', isAccount);
+    // ── Subject / Issuer ── both optional, but at least one must be set.
+    // Per XLS-0070 §5.1 + xrpl.js's `validateCredentialDelete`:
+    //   "either `Issuer` or `Subject` must be provided"
+    // The class API makes both required — see "Divergences" #1 in the
+    // header for the full citation trail.
+    const hasSubject = props.Subject !== undefined;
+    const hasIssuer = props.Issuer !== undefined;
+    if (!hasSubject && !hasIssuer) {
+        throw new ValidationError('CredentialDelete: either Subject or Issuer must be provided');
+    }
+    if (hasSubject && !isAccount(props.Subject)) {
+        throw new ValidationError('CredentialDelete: Subject must be a valid XRPL address');
+    }
+    if (hasIssuer && !isAccount(props.Issuer)) {
+        throw new ValidationError('CredentialDelete: Issuer must be a valid XRPL address');
+    }
+    // ── CredentialType ── required, hex Blob, 1–128 hex chars (1–64 bytes).
+    // Per XLS-0070 §2.1.3 + xrpl.js `validateCredentialType`:
+    //   non-empty, ≤ 64 decoded bytes, hex-encoded.
+    // The class API only does `isString` — see "Divergences" #2.
+    if (!isString(props.CredentialType) || props.CredentialType.length === 0) {
+        throw new ValidationError('CredentialDelete: CredentialType is required and must be a non-empty hex string');
+    }
+    if (props.CredentialType.length > MAX_CREDENTIAL_TYPE_HEX_LENGTH) {
+        throw new ValidationError(`CredentialDelete: CredentialType exceeds ${MAX_CREDENTIAL_TYPE_HEX_LENGTH} hex chars (${MAX_CREDENTIAL_TYPE_HEX_LENGTH / 2} bytes)`);
+    }
+    if (!isHex(props.CredentialType)) {
+        throw new ValidationError('CredentialDelete: CredentialType must be a hex string');
+    }
+    return buildFrozenTx('CredentialDelete', 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 credentialDelete(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=credential-delete.js.map

package/dist/fp/factories/credential-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-delete.js","sourceRoot":"","sources":["../../../src/fp/factories/credential-delete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0GG;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,+EAA+E;AAC/E,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAqC3C,wEAAwE;AAExE,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,qEAAqE;IACrE,OAAO,CACL,KAAK,CAAC,OAAO,EACb,uCAAuC,EACvC,SAAS,CACV,CAAC;IAEF,sEAAsE;IACtE,4DAA4D;IAC5D,oDAAoD;IACpD,kEAAkE;IAClE,sCAAsC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;IAC7C,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,eAAe,CACvB,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,eAAe,CACvB,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,eAAe,CACvB,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,0DAA0D;IAC1D,gDAAgD;IAChD,6DAA6D;IAC7D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,eAAe,CACvB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,8BAA8B,EAAE,CAAC;QACjE,MAAM,IAAI,eAAe,CACvB,4CAA4C,8BAA8B,eAAe,8BAA8B,GAAG,CAAC,SAAS,CACrI,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,eAAe,CACvB,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAClB,kBAAkB,EAClB,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,SAAyC;YAEzC,OAAO,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACzD,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,52 @@
+/**
+ * A single permission grant. Wraps a `PermissionValue` (the
+ * transaction-type string being delegated) in two layers of objects
+ * because that is the on-ledger shape; rippled's binary codec
+ * expects exactly this nesting.
+ */
+export interface Permission {
+    Permission: {
+        PermissionValue: string;
+    };
+}
+export interface DelegateSetProps {
+    /** The unique address of the transaction sender. */
+    Account: string;
+    /**
+     * The account being authorized to act on the sender's behalf.
+     * Must be a valid XRPL classic or X-address AND must not equal
+     * `Account` (self-delegation is rejected).
+     */
+    Authorize: string;
+    /**
+     * The transaction permissions being granted. Each entry must be of
+     * shape `{ Permission: { PermissionValue: string } }`. At most
+     * `PERMISSIONS_MAX_LENGTH` entries; no duplicate `PermissionValue`s;
+     * `PermissionValue` must be a string AND must not name a
+     * non-delegatable transaction.
+     */
+    Permissions: Permission[];
+    /** 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 DelegateSet extends Readonly<DelegateSetProps> {
+    readonly TransactionType: 'DelegateSet';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<DelegateSetProps>): DelegateSet;
+}
+/**
+ * Build a frozen DelegateSet. Throws `ValidationError` on construction
+ * if any required field is missing or malformed.
+ *
+ * The class-based equivalent 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 delegateSet(props: DelegateSetProps): DelegateSet;
+//# sourceMappingURL=delegate-set.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-set.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/delegate-set.ts"],"names":[],"mappings":"AA2HA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE;QACV,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,WAAW,EAAE,UAAU,EAAE,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,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;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CA+FhE"}