xrpjson 0.1.0

package/dist/fp/factories/xchain-add-claim-attestation.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Functional XChainAddClaimAttestation factory — frozen-object style.
+ *
+ * Provides a witness-server attestation that an `XChainCommit`
+ * transaction occurred on the source chain. The witness signs a message
+ * that names the destination chain account (`Destination`), the source
+ * chain account (`OtherChainSource`), the amount, and which side of the
+ * bridge the commit happened on (`WasLockingChainSend`).
+ *
+ *   import { xchainAddClaimAttestation } from 'xrplt/fp';
+ *   const tx = xchainAddClaimAttestation({
+ *     Account: ATTESTOR,
+ *     Amount: '100000000',
+ *     AttestationRewardAccount: REWARD,
+ *     AttestationSignerAccount: SIGNER,
+ *     Destination: 'r9A8UyNpW3X46FUc6P7JZqgn6WgAPjBwPg',
+ *     OtherChainSource: 'rnJmYAiqEVngtnb5ckRroXLtCbWC7CRUBx',
+ *     PublicKey: '03DAB289CA36FF377F3F4304C7A7203FDE5EDCBFC209F430F6A4355361425526D0',
+ *     Signature: '616263',
+ *     WasLockingChainSend: 1,
+ *     XChainClaimID: '0000000000000000',
+ *     XChainBridge: { ... },
+ *   });
+ *
+ * Required amendment: `XChainBridge`.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/xchainaddclaimattestation
+ * @see xrpl.js `packages/xrpl/src/models/transactions/XChainAddClaimAttestation.ts`
+ *      (`validateXChainAddClaimAttestation` — source of every required-
+ *      field check in this factory).
+ * @see XLS-0038 §2.3.3 — "The `XChainAddClaimAttestation` transaction"
+ *      `~/.mavis/docs.local/xrpl-standards/repo/XLS-0038-cross-chain-bridge/README.md`
+ *      lines 448–517 (Fields table at lines 462–473).
+ *
+ * ## Divergences
+ *
+ * The class-based API at
+ * `src/transactions/xchain-add-claim-attestation.ts` is missing several
+ * fields the canonical sources require AND exposes one field that is
+ * not in the spec at all. The factory corrects both:
+ *
+ *   1. **`AttestationRewardAccount` is required (XLS-38 §2.3.3.1.2).**
+ *      The class does not declare this field. xrpl.js requires
+ *      `validateRequiredField(tx, 'AttestationRewardAccount', isAccount)`
+ *      (`XChainAddClaimAttestation.ts:92`); XRPL.org marks it as
+ *      required (`xchainaddclaimattestation.md:79`); XLS-38 §2.3.3.1.2
+ *      (line 465) describes it as "The account that should receive
+ *      this signer's share of the `SignatureReward`." The factory
+ *      requires it as a valid XRPL classic/X-address.
+ *      Source: xrpl.js `XChainAddClaimAttestation.ts:92`;
+ *              XRPL.org `xchainaddclaimattestation.md:79`;
+ *              XLS-38 §2.3.3.1.2 (line 465).
+ *
+ *   2. **`AttestationSignerAccount` is required (XLS-38 §2.3.3.1.3).**
+ *      The class does not declare this field. xrpl.js requires
+ *      `validateRequiredField(tx, 'AttestationSignerAccount', isAccount)`
+ *      (`XChainAddClaimAttestation.ts:94`); XRPL.org marks it as
+ *      required (`xchainaddclaimattestation.md:80`); XLS-38 §2.3.3.1.3
+ *      (line 466) describes it as "the account on the door account's
+ *      signer list that is signing the transaction." The factory
+ *      requires it as a valid XRPL classic/X-address.
+ *      Source: xrpl.js `XChainAddClaimAttestation.ts:94`;
+ *              XRPL.org `xchainaddclaimattestation.md:80`;
+ *              XLS-38 §2.3.3.1.3 (line 466).
+ *
+ *   3. **`WasLockingChainSend` is the literal `0 | 1` union.** The
+ *      class does not declare this field at all (its `ASSIGNABLE_FIELDS`
+ *      list omits it). xrpl.js types it as `0 | 1` and validates with
+ *      `(inp): inp is 0 | 1 => inp === 0 || inp === 1`
+ *      (`XChainAddClaimAttestation.ts:65,104–108`). XRPL.org marks it
+ *      `Number / UInt8` required (`xchainaddclaimattestation.md:85`);
+ *      XLS-38 §2.3.3.1.8 (line 471) marks it required `UINT8`. The
+ *      factory requires it and rejects anything other than `0` or `1`.
+ *      Source: xrpl.js `XChainAddClaimAttestation.ts:65,104–108`;
+ *              XRPL.org `xchainaddclaimattestation.md:85`;
+ *              XLS-38 §2.3.3.1.8 (line 471).
+ *
+ *   4. **`XChainClaimID` accepts number OR string.** The class types the
+ *      field as `number` only. xrpl.js types it as `number | string`
+ *      (`XChainAddClaimAttestation.ts:76`) and validates with
+ *      `isNumber(inp) || isString(inp)` (line 114). XRPL.org marks it
+ *      `String / UInt64` internal type (`xchainaddclaimattestation.md:87`);
+ *      XLS-38 §2.3.3.1.10 (line 473) defines it as `UINT64`. The wire
+ *      format encodes UInt64 as a decimal string; callers frequently
+ *      pass it as a string. The factory accepts either.
+ *      Source: xrpl.js `XChainAddClaimAttestation.ts:76,113–116`;
+ *              XRPL.org `xchainaddclaimattestation.md:87`;
+ *              XLS-38 §2.3.3.1.10 (line 473).
+ *
+ *   5. **`XChainAttestationSequence` is NOT in the spec.** The class
+ *      declares `XChainAttestationSequence: number` as a required
+ *      field. XLS-38 §2.3.3.1 has no such field; xrpl.js's
+ *      `XChainAddClaimAttestation` interface (lines 22–77) has no
+ *      `XChainAttestationSequence`; XRPL.org's field table has no
+ *      `XChainAttestationSequence`. The factory omits this field
+ *      entirely.
+ *      Source: xrpl.js `XChainAddClaimAttestation.ts:22–77`
+ *              (no `XChainAttestationSequence` property);
+ *              XRPL.org `xchainaddclaimattestation.md:76–87`
+ *              (field table has no row for it);
+ *              XLS-38 §2.3.3.1 lines 462–473
+ *              (field table has no row for it).
+ *
+ *   6. **`XChainBridge` is fully shape-validated.** The class only
+ *      checks `isRecord` (line 52), which accepts any object including
+ *      `{}`. The factory uses the local `isXChainBridge` helper (4
+ *      keys, both Issues valid currency objects, both doors as
+ *      strings) AND verifies each door is a valid XRPL account
+ *      (mirrors `xchain-account-create-commit.ts` Divergences #3-#4
+ *      and `xchain-add-account-create-attestation.ts` Divergence #7,
+ *      applies to all bridge-bearing transactions).
+ *      Source: `src/validation/helpers.ts:168–177` (`isXChainBridge`);
+ *              xrpl.js `common.ts` `isXChainBridge` source of truth.
+ *
+ *   7. **`Account`, `AttestationRewardAccount`, `AttestationSignerAccount`,
+ *      and `OtherChainSource` are validated as valid XRPL classic or
+ *      X-addresses.** The class delegates `Account` to the base
+ *      transaction validator and does not validate the other three
+ *      account fields at all. The factory uses `isAccount` for all
+ *      four (and uses `isAccount` for the optional `Destination` when
+ *      present), matching the rest of the M4 fp family and xrpl.js's
+ *      `validateXChainAddClaimAttestation` (`XChainAddClaimAttestation.ts:92,94,96,98`).
+ *
+ *   8. **`PublicKey` and `Signature` must be non-empty hex Blobs.**
+ *      xrpl.js only checks `isString`
+ *      (`XChainAddClaimAttestation.ts:100,102`); XRPL.org marks both
+ *      as `String / Blob` internal type
+ *      (`xchainaddclaimattestation.md:83-84`). The factory enforces a
+ *      non-empty, even-length hex string so malformed blobs surface at
+ *      construction rather than at the binary codec layer. Per
+ *      XLS-38 §2.3.3.1.6 (line 469) and §2.3.3.1.7 (line 470),
+ *      `PublicKey` is conventionally a 33-byte compressed secp256k1
+ *      key (66 hex chars), but the wire format accepts any Blob so
+ *      we do NOT cap the length — the witness-server pubkey length is
+ *      a network convention, not a tx-format rule.
+ *      Source: XRPL.org `xchainaddclaimattestation.md:83-84`.
+ */
+import type { XChainBridge } from '../../types/common.js';
+export interface XchainAddClaimAttestationProps {
+    /** The unique address of the transaction sender (the witness
+     *  submitting this attestation). Required, valid XRPL address. */
+    Account: string;
+    /** The amount committed by the `XChainCommit` transaction on the
+     *  source chain. Currency Amount — XRP drops string, IOU object,
+     *  or MPT object. Required.
+     *  Source: XLS-38 §2.3.3.1.1 (line 464). */
+    Amount: string | Record<string, unknown>;
+    /** The account that should receive this signer's share of the
+     *  `SignatureReward`. Required, valid XRPL address.
+     *  Source: XLS-38 §2.3.3.1.2 (line 465). */
+    AttestationRewardAccount: string;
+    /** The account on the door account's signer list that is signing
+     *  the transaction. Required, valid XRPL address.
+     *  Source: XLS-38 §2.3.3.1.3 (line 466). */
+    AttestationSignerAccount: string;
+    /** The destination account for the funds on the destination chain
+     *  (taken from the `XChainCommit` transaction). Optional per
+     *  XLS-38 §2.3.3.1.4 (line 467), XRPL.org, and xrpl.js. When
+     *  present must be a valid XRPL address.
+     *  Source: XLS-38 §2.3.3.1.4 (line 467). */
+    Destination?: string | undefined;
+    /** The account on the source chain that submitted the `XChainCommit`
+     *  transaction that triggered the event associated with the
+     *  attestation. Required, valid XRPL address.
+     *  Source: XLS-38 §2.3.3.1.5 (line 468). */
+    OtherChainSource: string;
+    /** The public key used to verify the attestation signature. Hex
+     *  Blob; by convention a 33-byte compressed secp256k1 key (66 hex
+     *  chars). Required. */
+    PublicKey: string;
+    /** The signature attesting to the event on the other chain. Hex
+     *  Blob. Required. */
+    Signature: string;
+    /** Boolean (encoded as UInt8): true (=1) if the event occurred on
+     *  the locking chain (so `OtherChainSource` is on the locking
+     *  chain); false (=0) if on the issuing chain. Required, must be
+     *  exactly `0` or `1`.
+     *  Source: XLS-38 §2.3.3.1.8 (line 471). */
+    WasLockingChainSend: 0 | 1;
+    /** The `XChainClaimID` associated with the transfer, which was
+     *  included in the `XChainCommit` transaction. UInt64 — accepts
+     *  number or decimal string. Required.
+     *  Source: XLS-38 §2.3.3.1.10 (line 473). */
+    XChainClaimID: number | string;
+    /** The bridge associated with the attestation. 4-key shape with
+     *  both doors as valid XRPL accounts and both Issues as valid
+     *  currency objects. Required.
+     *  Source: XLS-38 §2.3.3.1.9 (line 472). */
+    XChainBridge: XChainBridge;
+    /** Bit-flags for this transaction. XChainAddClaimAttestation has no
+     *  defined flags; only `tfFullyCanonicalSig` (global) is normally
+     *  meaningful. Accepted for parity with the base tx shape. */
+    Flags?: number | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface XchainAddClaimAttestation extends Readonly<XchainAddClaimAttestationProps> {
+    readonly TransactionType: 'XChainAddClaimAttestation';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<XchainAddClaimAttestationProps>): XchainAddClaimAttestation;
+}
+export declare function xchainAddClaimAttestation(props: XchainAddClaimAttestationProps): XchainAddClaimAttestation;
+//# sourceMappingURL=xchain-add-claim-attestation.d.ts.map

package/dist/fp/factories/xchain-add-claim-attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xchain-add-claim-attestation.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/xchain-add-claim-attestation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA8D1D,MAAM,WAAW,8BAA8B;IAC7C;sEACkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAEhB;;;gDAG4C;IAC5C,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC;;gDAE4C;IAC5C,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;gDAE4C;IAC5C,wBAAwB,EAAE,MAAM,CAAC;IAEjC;;;;gDAI4C;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;gDAG4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;4BAEwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAElB;0BACsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAElB;;;;gDAI4C;IAC5C,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC;IAE3B;;;iDAG6C;IAC7C,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B;;;gDAG4C;IAC5C,YAAY,EAAE,YAAY,CAAC;IAE3B;;kEAE8D;IAC9D,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,yBACf,SAAQ,QAAQ,CAAC,8BAA8B,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,2BAA2B,CAAC;IACtD,QAAQ,IAAI,IAAI,CAAC;IACjB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CACF,SAAS,EAAE,OAAO,CAAC,8BAA8B,CAAC,GACjD,yBAAyB,CAAC;CAC9B;AAID,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,yBAAyB,CAyG3B"}

package/dist/fp/factories/xchain-add-claim-attestation.js

@@ -0,0 +1,97 @@
+import { isAccount, isAmount, isHex, isNumber, isString, isXChainBridge, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Validate a non-empty hex Blob per the XRPL.org field tables
+ * (`PublicKey` and `Signature`: `String / Blob` internal type). Even
+ * length is required for whole-byte serialisation.
+ */
+function validateBlob(value, field) {
+    if (!isString(value)) {
+        throw new ValidationError(`XChainAddClaimAttestation: ${field} must be a hex string`);
+    }
+    if (value.length === 0) {
+        throw new ValidationError(`XChainAddClaimAttestation: ${field} must not be an empty string`);
+    }
+    if (!isHex(value)) {
+        throw new ValidationError(`XChainAddClaimAttestation: ${field} must be encoded in hex`);
+    }
+    if (value.length % 2 !== 0) {
+        throw new ValidationError(`XChainAddClaimAttestation: ${field} must have an even number of hex characters (whole-byte Blob encoding)`);
+    }
+    return value;
+}
+/**
+ * Verify both XChainBridge doors are valid XRPL account addresses
+ * (the local `isXChainBridge` helper only checks `typeof === 'string'`).
+ */
+function assertValidXChainBridge(bridge) {
+    if (!isAccount(bridge.LockingChainDoor)) {
+        throw new ValidationError('XChainAddClaimAttestation: XChainBridge.LockingChainDoor must be a valid XRPL account address');
+    }
+    if (!isAccount(bridge.IssuingChainDoor)) {
+        throw new ValidationError('XChainAddClaimAttestation: XChainBridge.IssuingChainDoor must be a valid XRPL account address');
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function xchainAddClaimAttestation(props) {
+    // ── Account ── required, valid XRPL classic/X-address.
+    require(props.Account, 'XChainAddClaimAttestation: missing or invalid Account', isAccount);
+    // ── Amount ── required, any Currency Amount form (XRP / IOU / MPT).
+    if (!isAmount(props.Amount)) {
+        throw new ValidationError('XChainAddClaimAttestation: Amount must be a Currency Amount (XRP drops string, IOU object, or MPT object)');
+    }
+    // ── AttestationRewardAccount ── required, valid XRPL account.
+    //    Class API does not declare this field at all.
+    require(props.AttestationRewardAccount, 'XChainAddClaimAttestation: missing or invalid AttestationRewardAccount', isAccount);
+    // ── AttestationSignerAccount ── required, valid XRPL account.
+    //    Class API does not declare this field at all.
+    require(props.AttestationSignerAccount, 'XChainAddClaimAttestation: missing or invalid AttestationSignerAccount', isAccount);
+    // ── Destination ── optional per spec, but when present must be a
+    //    valid XRPL account.
+    if (props.Destination !== undefined) {
+        if (!isAccount(props.Destination)) {
+            throw new ValidationError('XChainAddClaimAttestation: Destination is not a valid XRPL account address');
+        }
+    }
+    // ── OtherChainSource ── required, valid XRPL account.
+    //    Class API does not declare this field at all.
+    require(props.OtherChainSource, 'XChainAddClaimAttestation: missing or invalid OtherChainSource', isAccount);
+    // ── PublicKey ── required, non-empty even-length hex Blob.
+    validateBlob(props.PublicKey, 'PublicKey');
+    // ── Signature ── required, non-empty even-length hex Blob.
+    validateBlob(props.Signature, 'Signature');
+    // ── WasLockingChainSend ── required, exactly 0 or 1.
+    if (props.WasLockingChainSend !== 0 && props.WasLockingChainSend !== 1) {
+        throw new ValidationError('XChainAddClaimAttestation: WasLockingChainSend must be exactly 0 or 1 (UInt8 boolean)');
+    }
+    // ── XChainClaimID ── required, number OR string (UInt64).
+    if (!isNumber(props.XChainClaimID) && !isString(props.XChainClaimID)) {
+        throw new ValidationError('XChainAddClaimAttestation: XChainClaimID must be a number or decimal string (UInt64)');
+    }
+    // ── XChainBridge ── required, full shape (4 keys + valid Issues) +
+    //    both doors as valid XRPL accounts.
+    require(props.XChainBridge, 'XChainAddClaimAttestation: XChainBridge is required and must have shape {LockingChainDoor, LockingChainIssue, IssuingChainDoor, IssuingChainIssue}', isXChainBridge);
+    assertValidXChainBridge(props.XChainBridge);
+    return buildFrozenTx('XChainAddClaimAttestation', 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 xchainAddClaimAttestation(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=xchain-add-claim-attestation.js.map

package/dist/fp/factories/xchain-add-claim-attestation.js.map

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

package/dist/fp/factories/xchain-claim.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Functional XChainClaim factory — frozen-object style.
+ *
+ * Completes a cross-chain transfer of value by claiming funds on the
+ * destination chain after a quorum of witness attestations have been
+ * delivered for a corresponding `XChainCommit` transaction. Validation
+ * happens at construction; there is no way to construct an invalid tx.
+ *
+ *   import { xchainClaim } from 'xrplt/fp';
+ *   const tx = xchainClaim({
+ *     Account,
+ *     Amount: '10000',
+ *     XChainClaimID: '13f',
+ *     Destination: 'rahDmoXrtPdh7sUdrPjini3gcnTVYjbjjw',
+ *     XChainBridge: {
+ *       LockingChainDoor: 'rMAXACCrp3Y8PpswXcg3bKggHX76V3F8M4',
+ *       LockingChainIssue: { currency: 'XRP' },
+ *       IssuingChainDoor: 'rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh',
+ *       IssuingChainIssue: { currency: 'XRP' },
+ *     },
+ *   });
+ *
+ * Required amendment: `XChainBridge`.
+ *
+ * @see https://xrpl.org/docs/references/protocol/transactions/types/xchainclaim
+ * @see xrpl.js `packages/xrpl/src/models/transactions/XChainClaim.ts`
+ *      (`validateXChainClaim` — source of every required-field check in
+ *      this factory).
+ * @see XLS-0038 §2.3.4 — "The `XChainClaim` transaction"
+ *      `~/.mavis/docs.local/xrpl-standards/repo/XLS-0038-cross-chain-bridge/README.md`
+ *      lines 519–559.
+ *
+ * ## Divergences
+ *
+ * Compared with `src/transactions/xchain-claim.ts`, this factory adds
+ * guards the class skips (or that xrpl.js / xrpl.org / XLS-38 mandate
+ * but the class omits):
+ *
+ * - **`Account` must be a valid XRPL classic or X-address.** The class
+ *   accepts any string via `super.validate()` (which only checks
+ *   `isString`). xrpl.js's `validateBaseTransaction` (which
+ *   `validateXChainClaim` delegates to) enforces a valid classic
+ *   address; we mirror that at construction.
+ *   - Source: xrpl.js `common.ts` `validateBaseTransaction`.
+ *   - Cross-ref: rippled parses `Account` as `STAccount`; only valid
+ *     XRPL classic addresses parse.
+ *
+ * - **`Destination` must be a valid XRPL classic or X-address.** The
+ *   class does not validate `Destination` at all (no `validate()` check,
+ *   just `declare readonly Destination`). xrpl.js
+ *   `validateXChainClaim` line 74 calls
+ *   `validateRequiredField(tx, 'Destination', isAccount)`. xrpl.org
+ *   `xchainclaim.md` line 47 marks it `String / AccountID`; XLS-38
+ *   §2.3.4.1.3 line 548 defines `Destination` as `ACCOUNT`.
+ *   - Source: xrpl.js `XChainClaim.ts` line 74.
+ *   - Source: xrpl.org `xchainclaim.md` line 47.
+ *   - Source: XLS-38 §2.3.4.1.3 line 548.
+ *   - Cross-ref: rippled parses `Destination` as `STAccount`; only
+ *     valid XRPL classic addresses parse.
+ *
+ * - **`XChainBridge` is fully shape-validated.** xrpl.js
+ *   `validateXChainClaim` line 66 calls
+ *   `validateRequiredField(tx, 'XChainBridge', isXChainBridge)`, which
+ *   requires exactly 4 keys, two `AccountID` door strings, and two
+ *   `Issue` currency objects (`{currency: 'XRP'}` or
+ *   `{currency, issuer}`). The class only verifies `isRecord`, which
+ *   accepts any object (including `{}` or `{foo: 'bar'}`). The factory
+ *   uses the local `isXChainBridge` helper to enforce the full shape.
+ *   - Source: xrpl.js `common.ts` `isXChainBridge`.
+ *   - Source: XLS-38 §2.1.1.1.2 lines 175–180 (bridge fields are
+ *     `XCHAIN_BRIDGE` internal type; all 4 sub-fields required).
+ *   - Cross-ref: our `src/validation/helpers.ts` `isXChainBridge`
+ *     (lines 168–177) mirrors the xrpl.js check.
+ *
+ * - **Both `XChainBridge` doors must be valid XRPL classic / X
+ *   addresses.** `isXChainBridge` only checks that the door strings
+ *   are strings; rippled parses them as `STAccount`. The factory
+ *   additionally runs `isAccount` on each door so a malformed door
+ *   string is caught at construction.
+ *   - Source: rippled `XChainBridge.h:94–126` (parses `sfLockingChainDoor`,
+ *     `sfIssuingChainDoor` as `STAccount`).
+ *   - Cross-ref: XLS-38 §2.1.1.1.2 line 177 (`LockingChainDoor` is
+ *     `ACCOUNT`); line 179 (`IssuingChainDoor` is `ACCOUNT`).
+ *
+ * - **`XChainClaimID` accepts number OR decimal string (UInt64).** The
+ *   class types the field as `number` only. xrpl.js types it as
+ *   `number | string` (`XChainClaim.ts:35`) and validates with
+ *   `isNumber(inp) || isString(inp)` (line 71). xrpl.org
+ *   `xchainclaim.md` line 50 marks it `String / UInt64`; XLS-38
+ *   §2.3.4.1.2 line 543 defines it as `UINT64`. The wire format
+ *   encodes UInt64 as a decimal string; callers frequently pass it as
+ *   a string. The factory accepts either, and when a string is provided
+ *   verifies it is a decimal integer in `[0, 2^64-1]`.
+ *   - Source: xrpl.js `XChainClaim.ts:35,68–72`.
+ *   - Source: xrpl.org `xchainclaim.md` line 50.
+ *   - Source: XLS-38 §2.3.4.1.2 line 543.
+ *
+ * - **`DestinationTag` is exposed (XLS-38 §2.3.4.1.4).** The class
+ *   does not declare this field at all. xrpl.js marks it optional with
+ *   `DestinationTag?: number` (`XChainClaim.ts:48`) and validates with
+ *   `validateOptionalField(tx, 'DestinationTag', isNumber)` (line 76).
+ *   xrpl.org `xchainclaim.md` line 48 marks it `Number / UInt32`
+ *   optional; XLS-38 §2.3.4.1.4 line 551 defines it as `UINT32`. The
+ *   factory exposes the field, requires it to be a UInt32 when present,
+ *   and rejects non-integers / negatives / values > 4294967295.
+ *   - Source: xrpl.js `XChainClaim.ts:48,76`.
+ *   - Source: xrpl.org `xchainclaim.md` line 48.
+ *   - Source: XLS-38 §2.3.4.1.4 line 551.
+ *
+ * - **`Amount` must be strictly positive.** The class delegates to
+ *   `isAmount`, which accepts `Amount: '0'` (XRP string) and
+ *   `{value: '0'}` (IOU/MPT). Per XLS-38 §2.3.4.1.5 line 559, "This
+ *   must match the amount attested to on the attestations associated
+ *   with this `XChainClaimID`." The attestations record a non-zero
+ *   amount (XChainCommit cannot commit 0), so a 0 Amount here would
+ *   never match an attestation and would be rejected on-ledger. The
+ *   factory enforces `> 0` across all three Amount forms (XRP string,
+ *   IOU `value`, MPT `value`).
+ *   - Source: XLS-38 §2.3.4.1.5 line 559 ("must match the amount
+ *     attested to ... XChainClaimID").
+ *   - Source: XLS-38 §2.3.2.1.3 line 440 (XChainCommit Amount must
+ *     match the door's `LockingChainIssue`/`IssuingChainIssue`; the
+ *     commit must be a positive transfer).
+ *   - Cross-ref: xrpl.js `isAmount` accepts any shape; the strict
+ *     `> 0` check is a factory addition.
+ *
+ * - **`OtherChainSource` is NOT a field on this transaction.** Some
+ *   XLS-38 transactions carry an `OtherChainSource` (e.g.
+ *   `XChainAddClaimAttestation` §2.3.3.1.5), but it is explicitly
+ *   absent from XChainClaim's field table (§2.3.4.1 lines 533–537).
+ *   The factory correctly omits `OtherChainSource`. (Documented for
+ *   awareness; this is a spec clarification, not a divergence from the
+ *   class.)
+ *   - Source: XLS-38 §2.3.4.1 lines 533–537 (no `OtherChainSource`
+ *     row in the field table).
+ *   - Source: XLS-38 §2.3.3.1.5 line 468 (the attestation carries
+ *     `OtherChainSource`, not the claim).
+ *
+ * - **`Flags` accepted for parity with the base transaction shape.**
+ *   XChainClaim itself defines no transaction-specific flags; only
+ *   `tfFullyCanonicalSig` (global) is normally meaningful. The class
+ *   does not declare a `Flags` field. We accept a numeric bitmask
+ *   for parity with the rest of the fp family.
+ *   - Source: XLS-38 §2.3.4.1 lines 533–537 (no `Flags` row).
+ *   - Cross-ref: rippled accepts the `Flags` field for any transaction
+ *     (it just defaults to `tfFullyCanonicalSig`).
+ */
+import type { Amount } from '../../types/amounts.js';
+import type { XChainBridge } from '../../types/common.js';
+export interface XchainClaimProps {
+    /** The unique address of the transaction sender (the account that
+     *  owns the `XChainOwnedClaimID` on the destination chain). */
+    Account: string;
+    /** The bridge associated with this transfer. 4-key shape with both
+     *  doors as valid XRPL classic/X addresses and both Issues as valid
+     *  currency objects. */
+    XChainBridge: XChainBridge;
+    /** The unique integer ID for a cross-chain transfer that was
+     *  referenced in the corresponding `XChainCommit` transaction.
+     *  UInt64 — accepts number or decimal string. */
+    XChainClaimID: number | string;
+    /** The destination account on the destination chain. Must exist for
+     *  the transaction to succeed. Valid XRPL classic/X address. */
+    Destination: string;
+    /** Optional UInt32 destination tag. */
+    DestinationTag?: number | undefined;
+    /** The amount to claim on the destination chain. Must match the
+     *  amount attested to on the attestations associated with this
+     *  `XChainClaimID`. Strictly positive (> 0). */
+    Amount: Amount;
+    /** Bit-flags for this transaction. XChainClaim has no defined
+     *  flags; only `tfFullyCanonicalSig` (global) is normally meaningful.
+     *  Accepted for parity with the base tx shape. */
+    Flags?: number | undefined;
+    /** Fee in XRP (drops), base-10 integer string. */
+    Fee?: string | undefined;
+    /** Account sequence number. */
+    Sequence?: number | undefined;
+}
+export interface XchainClaim extends Readonly<XchainClaimProps> {
+    readonly TransactionType: 'XChainClaim';
+    validate(): void;
+    toJSON(): Record<string, unknown>;
+    with(overrides: Partial<XchainClaimProps>): XchainClaim;
+}
+export declare function xchainClaim(props: XchainClaimProps): XchainClaim;
+//# sourceMappingURL=xchain-claim.d.ts.map

package/dist/fp/factories/xchain-claim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xchain-claim.d.ts","sourceRoot":"","sources":["../../../src/fp/factories/xchain-claim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkJG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAoJ1D,MAAM,WAAW,gBAAgB;IAC/B;mEAC+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAEhB;;4BAEwB;IACxB,YAAY,EAAE,YAAY,CAAC;IAE3B;;qDAEiD;IACjD,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B;oEACgE;IAChE,WAAW,EAAE,MAAM,CAAC;IAEpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC;;oDAEgD;IAChD,MAAM,EAAE,MAAM,CAAC;IAEf;;sDAEkD;IAClD,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,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;AAID,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAsEhE"}

package/dist/fp/factories/xchain-claim.js

@@ -0,0 +1,140 @@
+import { isAccount, isAmount, isIssuedCurrencyAmount, isMPTAmount, isNumber, isString, isXChainBridge, } from '../../validation/helpers.js';
+import { ValidationError } from '../../errors.js';
+import { buildFrozenTx, mergeForWith, require } from '../shape.js';
+// ─── Spec constants ──────────────────────────────────────────────────
+// XLS-38 §2.3.4.1.2 line 543: XChainClaimID is UInt64.
+const UINT64_MIN = 0n;
+const UINT64_MAX = (1n << 64n) - 1n;
+// XLS-38 §2.3.4.1.4 line 551: DestinationTag is UInt32.
+const UINT32_MIN = 0;
+const UINT32_MAX = 0xffffffff;
+// Non-negative base-10 integer string used for Amount value parsing.
+const DECIMAL_INT_REGEX = /^[0-9]+$/u;
+// ─── Helpers ─────────────────────────────────────────────────────────
+/**
+ * Verify both XChainBridge doors are valid XRPL account addresses
+ * (the local `isXChainBridge` helper only checks `typeof === 'string'`).
+ */
+function assertValidXChainBridge(bridge) {
+    if (!isAccount(bridge.LockingChainDoor)) {
+        throw new ValidationError('XChainClaim: XChainBridge.LockingChainDoor must be a valid XRPL account address');
+    }
+    if (!isAccount(bridge.IssuingChainDoor)) {
+        throw new ValidationError('XChainClaim: XChainBridge.IssuingChainDoor must be a valid XRPL account address');
+    }
+}
+/**
+ * Validate that an Amount is strictly positive across all three forms
+ * (XRP drops string, IssuedCurrencyAmount, MPTAmount). Mirrors the
+ * OfferCreate / NFTokenCreateOffer positivity checks but accepts any
+ * Amount shape (XChainClaim is bridge-agnostic; XRP-XRP and IOU-IOU
+ * bridges are both supported, XLS-38 §2.3.4 has no asset restriction).
+ */
+function validatePositiveAmount(amount, path) {
+    if (!isAmount(amount)) {
+        throw new ValidationError(`XChainClaim: ${path} must be a valid Amount (XRP drops string, IOU object, or MPT object)`);
+    }
+    if (isString(amount)) {
+        if (!DECIMAL_INT_REGEX.test(amount)) {
+            throw new ValidationError(`XChainClaim: ${path} (XRP) must be a non-negative base-10 integer string`);
+        }
+        if (amount === '0') {
+            throw new ValidationError(`XChainClaim: ${path} must be strictly positive (XRP); got "0"`);
+        }
+        return;
+    }
+    if (isIssuedCurrencyAmount(amount)) {
+        if (!isString(amount.value) || !DECIMAL_INT_REGEX.test(amount.value)) {
+            throw new ValidationError(`XChainClaim: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        if (amount.value === '0') {
+            throw new ValidationError(`XChainClaim: ${path} must be strictly positive (IOU); got value "0"`);
+        }
+        return;
+    }
+    if (isMPTAmount(amount)) {
+        if (!isString(amount.value) || !DECIMAL_INT_REGEX.test(amount.value)) {
+            throw new ValidationError(`XChainClaim: ${path}.value must be a non-negative base-10 integer string`);
+        }
+        if (amount.value === '0') {
+            throw new ValidationError(`XChainClaim: ${path} must be strictly positive (MPT); got value "0"`);
+        }
+        return;
+    }
+    // Unreachable — defensive.
+    throw new ValidationError(`XChainClaim: ${path} must be a valid Amount (XRP drops string, IOU object, or MPT object)`);
+}
+/**
+ * Validate that an XChainClaimID value (number or decimal string)
+ * fits in `[0, 2^64-1]`. The wire format encodes UInt64 as a decimal
+ * string; this helper normalises both forms into BigInt and range-
+ * checks.
+ */
+function validateXChainClaimIDValue(value, field) {
+    if (typeof value === 'number') {
+        if (!Number.isInteger(value) || value < 0 || value > Number.MAX_SAFE_INTEGER) {
+            throw new ValidationError(`XChainClaim: ${field} numeric form must be a non-negative safe integer (UInt64)`);
+        }
+        return;
+    }
+    if (!DECIMAL_INT_REGEX.test(value)) {
+        throw new ValidationError(`XChainClaim: ${field} string form must be a decimal integer (UInt64)`);
+    }
+    let big;
+    try {
+        big = BigInt(value);
+    }
+    catch {
+        throw new ValidationError(`XChainClaim: ${field} string form is not a valid integer (UInt64)`);
+    }
+    if (big < UINT64_MIN || big > UINT64_MAX) {
+        throw new ValidationError(`XChainClaim: ${field} is out of UInt64 range [0, ${UINT64_MAX}]`);
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────
+export function xchainClaim(props) {
+    // ── Account ── required, valid XRPL classic/X-address.
+    require(props.Account, 'XChainClaim: missing or invalid Account', isAccount);
+    // ── XChainBridge ── required, full shape (4 keys + valid Issues) +
+    //    both doors as valid XRPL accounts.
+    require(props.XChainBridge, 'XChainClaim: XChainBridge is required and must have shape {LockingChainDoor, LockingChainIssue, IssuingChainDoor, IssuingChainIssue}', isXChainBridge);
+    assertValidXChainBridge(props.XChainBridge);
+    // ── XChainClaimID ── required, number OR decimal string (UInt64).
+    if (!isNumber(props.XChainClaimID) && !isString(props.XChainClaimID)) {
+        throw new ValidationError('XChainClaim: XChainClaimID must be a number or decimal string (UInt64)');
+    }
+    validateXChainClaimIDValue(props.XChainClaimID, 'XChainClaimID');
+    // ── Destination ── required, valid XRPL account.
+    require(props.Destination, 'XChainClaim: missing or invalid Destination', isAccount);
+    // ── DestinationTag ── optional UInt32 (XLS-38 §2.3.4.1.4).
+    if (props.DestinationTag !== undefined) {
+        if (!isNumber(props.DestinationTag) ||
+            !Number.isInteger(props.DestinationTag) ||
+            props.DestinationTag < UINT32_MIN ||
+            props.DestinationTag > UINT32_MAX) {
+            throw new ValidationError(`XChainClaim: DestinationTag must be a UInt32 in [${UINT32_MIN}, ${UINT32_MAX}]`);
+        }
+    }
+    // ── Amount ── required, any Currency Amount form, strictly positive.
+    validatePositiveAmount(props.Amount, 'Amount');
+    return buildFrozenTx('XChainClaim', 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 xchainClaim(mergeForWith(this, overrides));
+        },
+    });
+}
+//# sourceMappingURL=xchain-claim.js.map

package/dist/fp/factories/xchain-claim.js.map

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