@florent-uzio/custody 2.2.0 → 2.4.0

package/dist/services/xrpl/xrpl.types.d.ts

@@ -1,8 +1,9 @@
-import type { AccountSet, Clawback, DepositPreauth, MPTokenAuthorize, MPTokenIssuanceCreate, MPTokenIssuanceDestroy, MPTokenIssuanceSet, OfferCreate, Payment, SubmittableTransaction, TrustSet } from "xrpl";
+import type { AccountSet, Batch, BatchSigner, Clawback, DepositPreauth, MPTokenAuthorize, MPTokenIssuanceCreate, MPTokenIssuanceDestroy, MPTokenIssuanceSet, OfferCreate, Payment, SubmittableTransaction, TicketCreate, TrustSet } from "xrpl";
 import type { components } from "../../models/custody-types.js";
 import type { XrplLedgerId } from "../../models/ledger-ids.js";
 import type { Prettify } from "../../type-utils/index.js";
 import type { DomainUserReference } from "../domain-resolver/index.js";
+import type { Core_IntentResponse } from "../intents/intents.types.js";
 /**
  * Minimum set of account fields required to build an XRPL intent.
  * Consumed by `IntentContext`. Not an API response shape — see
@@ -36,8 +37,23 @@ type Core_XrplOperation_MPTokenIssuanceDestroy = components["schemas"]["Core_Xrp
 export type CustodyMpTokenIssuanceDestroy = Prettify<Pick<MPTokenIssuanceDestroy, "Account"> & Omit<Core_XrplOperation_MPTokenIssuanceDestroy, "type">>;
 export type Core_XrplOperation_OfferCreate = components["schemas"]["Core_XrplOperation_OfferCreate"];
 export type CustodyOfferCreate = Prettify<Pick<OfferCreate, "Account"> & Omit<Core_XrplOperation_OfferCreate, "type">>;
+export type Core_XrplOperation_TicketCreate = components["schemas"]["Core_XrplOperation_TicketCreate"];
+export type CustodyTicketCreate = Prettify<Pick<TicketCreate, "Account"> & Omit<Core_XrplOperation_TicketCreate, "type">>;
 export type Core_XrplOperation_AccountSet = components["schemas"]["Core_XrplOperation_AccountSet"];
 export type CustodyAccountSet = Prettify<Pick<AccountSet, "Account"> & Omit<Core_XrplOperation_AccountSet, "type">>;
+export type Core_XrplOperation_Batch = components["schemas"]["Core_XrplOperation_Batch"];
+export type CustodyBatch = Prettify<Pick<Batch, "Account"> & Omit<Core_XrplOperation_Batch, "type">>;
+export type CustodyBatchSigner = CustodyBatch["batchSigners"][number];
+export type CustodyInnerTransaction = CustodyBatch["entries"][number];
+export type CustodyOperation = CustodyInnerTransaction["operation"];
+export type Core_ParticipantSequencing = components["schemas"]["Core_ParticipantSequencing"];
+export type Core_BatchEntry = components["schemas"]["Core_BatchEntry"];
+export type Core_BatchSigner = components["schemas"]["Core_BatchSigner"];
+export type Core_Sequencing = components["schemas"]["Core_Sequencing"];
+export type Core_BatchExecutionMode = components["schemas"]["Core_Xrpl_BatchExecutionMode"];
+export type Core_ApiBatchSigningData = components["schemas"]["Core_ApiBatchSigningData"];
+export type Core_TransactionEstimate_XRPL = components["schemas"]["Core_TransactionEstimate_XRPL"];
+export type Core_IntentDryRunResponse_v0_CreateTransactionOrder = components["schemas"]["Core_IntentDryRunResponse_v0_CreateTransactionOrder"];
 export type CustodyAccountSetFlag = CustodyAccountSet["setFlag"];
 export type XrplIntentOptions = {
     /**
@@ -59,6 +75,10 @@ export type XrplIntentOptions = {
      * Number of days until the intent expires. Defaults to 1.
      */
     expiryDays?: number;
+    /**
+     * Human-readable description for the intent request (`request.description`).
+     */
+    description?: string;
     /**
      * Custom properties to include in the intent request.
      */
@@ -117,15 +137,100 @@ export type RawSignAndWaitResult = {
     /** The transaction with TxnSignature and SigningPubKey set, ready to submit */
     signedTransaction: SubmittableTransaction;
 };
-export {};
+type BatchSignerLookup = {
+    accountId?: never;
+    ledgerId?: never;
+};
+type BatchSignerDirect = {
+    /** Custody account ID — skips the address lookup when provided with ledgerId */
+    accountId: string;
+    /** Ledger ID for the account */
+    ledgerId: string;
+};
+/**
+ * Input for `dryRunBatch` / `proposeBatch`.
+ *
+ * `Account` is the submitter (pays the outer Batch fee). `entries` mixes
+ * `SubmitterOperation` and `ParticipantOperation`; build them by hand with
+ * `Core_BatchEntry`, or convert from an autofilled xrpl.js `Batch` with
+ * `batchToCustodyInnerTransactions`.
+ */
+export type BatchPayloadInput = {
+    /** XRPL address of the submitter (the account that pays the outer Batch fee) */
+    Account: string;
+    /** How the XRP Ledger handles inner-operation failures */
+    executionMode: Core_BatchExecutionMode;
+    /** Inner operations (SubmitterOperation or ParticipantOperation) */
+    entries: Core_BatchEntry[];
+    /** Outer Batch sequencing. Defaults to `{ type: "PlatformManaged" }` */
+    sequencing?: Core_Sequencing;
+    /** Optional last ledger sequence for the outer Batch */
+    lastLedgerSequence?: number;
+};
 /**
- * Result of rawSignInnerBatchAndWait.
- * Extends RawSignAndWaitResult with batch signer representations.
+ * Options for signing the `signingPayload` returned by `dryRunBatch` for an
+ * inner account managed by this custody instance.
+ *
+ * When `accountId` and `ledgerId` are provided, the address-to-account lookup
+ * is skipped.
  */
+export type SignBatchPayloadOptions = XrplIntentOptions & {
+    /** Polling options for waiting for the manifest signature */
+    polling?: WaitForSignatureOptions;
+} & (BatchSignerLookup | BatchSignerDirect);
 /**
- * Options for rawSignInnerBatch / rawSignInnerBatchAndWait: intent options + polling configuration.
+ * Result of `signBatchPayloadAndWait`.
  *
- * When `accountId` and `ledgerId` are provided, the address-to-account lookup is
- * skipped, saving an API call.
+ * `signature` and `signingPubKey` are uppercase hex. `batchSigner` is the
+ * xrpl.js `BatchSigner` shape; `custodyBatchSigner` is the {% PUBLIC_VAR_CUS %}
+ * shape — pick whichever the next step needs.
  */
+export type SignBatchPayloadResult = {
+    /** The signature in uppercase hex */
+    signature: string;
+    /** The compressed secp256k1 public key in uppercase hex */
+    signingPubKey: string;
+    /** xrpl.js BatchSigner — for inclusion in an xrpl.js Batch.BatchSigners array */
+    batchSigner: BatchSigner;
+    /** Custody BatchSigner — for inclusion in batchSigners on `proposeBatch` */
+    custodyBatchSigner: CustodyBatchSigner;
+};
+/**
+ * Serializable handle returned by `signBatchPayload`. Persist these fields
+ * (e.g. to a database or queue) and pass them to `getBatchSignature` once the
+ * custody instance operator has approved the signature — possibly from a
+ * different process.
+ */
+export type SignBatchPayloadHandle = {
+    /** Manifest ID to poll for the signature */
+    payloadId: string;
+    /** Domain ID of the signer account */
+    domainId: string;
+    /** Account ID of the signer account */
+    accountId: string;
+    /** XRPL address of the signer */
+    signerAddress: string;
+    /** The compressed secp256k1 public key in uppercase hex */
+    signingPubKey: string;
+    /** The proposed intent response */
+    intentResponse: Core_IntentResponse;
+};
+/**
+ * Fields `getBatchSignature` needs to fetch the signature and build the
+ * BatchSigner shapes. A `SignBatchPayloadHandle` is a structural superset, so a
+ * stored handle can be passed directly.
+ */
+export type GetBatchSignatureParams = {
+    /** Manifest ID returned by `signBatchPayload` */
+    payloadId: string;
+    /** Domain ID of the signer account */
+    domainId: string;
+    /** Account ID of the signer account */
+    accountId: string;
+    /** XRPL address of the signer */
+    signerAddress: string;
+    /** The compressed secp256k1 public key in uppercase hex */
+    signingPubKey: string;
+};
+export {};
 //# sourceMappingURL=xrpl.types.d.ts.map

package/dist/services/xrpl/xrpl.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xrpl.types.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xrpl.types.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.types.ts"],"names":[],"mappings":"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"}

package/dist/services/xrpl/xrpl.types.js

@@ -1,30 +1,2 @@
 export {};
-/**
- * Result of rawSignInnerBatchAndWait.
- * Extends RawSignAndWaitResult with batch signer representations.
- */
-// export type RawSignInnerBatchAndWaitResult = RawSignAndWaitResult & {
-//   /** The batch signer in xrpl.js format */
-//   batchSigner: BatchSigner
-//   /** The batch signer in Ripple Custody API format */
-//   //TODO: delete comment once Batch is supported
-//   // custodyBatchSigner: CustodyBatchSigner
-// }
-// type BatchSignerLookup = { accountId?: never; ledgerId?: never }
-// type BatchSignerDirect = {
-//   /** Custody account ID — skips the address lookup when provided with ledgerId */
-//   accountId: string
-//   /** Ledger ID for the account */
-//   ledgerId: string
-// }
-/**
- * Options for rawSignInnerBatch / rawSignInnerBatchAndWait: intent options + polling configuration.
- *
- * When `accountId` and `ledgerId` are provided, the address-to-account lookup is
- * skipped, saving an API call.
- */
-// export type RawSignInnerBatchOptions = XrplIntentOptions & {
-//   /** Polling options for waiting for the manifest signature */
-//   polling?: WaitForSignatureOptions
-// } & (BatchSignerLookup | BatchSignerDirect)
 //# sourceMappingURL=xrpl.types.js.map

package/dist/services/xrpl/xrpl.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"xrpl.types.js","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.types.ts"],"names":[],"mappings":";AA6NA;;;GAGG;AACH,wEAAwE;AACxE,8CAA8C;AAC9C,6BAA6B;AAC7B,yDAAyD;AACzD,mDAAmD;AACnD,8CAA8C;AAC9C,IAAI;AAEJ,mEAAmE;AACnE,6BAA6B;AAC7B,qFAAqF;AACrF,sBAAsB;AACtB,qCAAqC;AACrC,qBAAqB;AACrB,IAAI;AAEJ;;;;;GAKG;AACH,+DAA+D;AAC/D,kEAAkE;AAClE,sCAAsC;AACtC,8CAA8C"}
+{"version":3,"file":"xrpl.types.js","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.types.ts"],"names":[],"mappings":""}

package/dist/services/xrpl/xrpl.validators.d.ts

@@ -0,0 +1,23 @@
+import type { BatchPayloadInput } from "./xrpl.types.js";
+/**
+ * Validates that a Batch's sequencing is internally consistent, surfacing the
+ * rule the Custody server enforces as a local `CustodyError` before the payload
+ * is sent (e.g. via `dryRunBatch`).
+ *
+ * A Batch must be sequenced one of two ways — mixing them is rejected:
+ * - **Fully explicit**: the outer Batch and every entry use `AccountSequence`
+ *   or `Ticket`.
+ * - **Fully platform-managed**: the outer Batch and every entry use
+ *   `PlatformManaged`. This is only possible for a submitter-only Batch, since
+ *   participant entries are always explicitly sequenced.
+ *
+ * A frequent cause of a mixed configuration is omitting the outer `sequencing`
+ * (which defaults to `PlatformManaged`, matching `buildBatchOperation`) while
+ * the entries carry `AccountSequence`/`Ticket` — for example entries produced
+ * by `batchToCustodyInnerTransactions`.
+ *
+ * @param payload - The Batch payload passed to `dryRunBatch` / `proposeBatch`
+ * @throws {CustodyError} If the outer Batch and entries mix the two sequencing modes
+ */
+export declare function validateBatchSequencing(payload: BatchPayloadInput): void;
+//# sourceMappingURL=xrpl.validators.d.ts.map

package/dist/services/xrpl/xrpl.validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrpl.validators.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.validators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAwBxE"}

package/dist/services/xrpl/xrpl.validators.js

@@ -0,0 +1,43 @@
+import { CustodyError } from "../../models/index.js";
+/**
+ * Validates that a Batch's sequencing is internally consistent, surfacing the
+ * rule the Custody server enforces as a local `CustodyError` before the payload
+ * is sent (e.g. via `dryRunBatch`).
+ *
+ * A Batch must be sequenced one of two ways — mixing them is rejected:
+ * - **Fully explicit**: the outer Batch and every entry use `AccountSequence`
+ *   or `Ticket`.
+ * - **Fully platform-managed**: the outer Batch and every entry use
+ *   `PlatformManaged`. This is only possible for a submitter-only Batch, since
+ *   participant entries are always explicitly sequenced.
+ *
+ * A frequent cause of a mixed configuration is omitting the outer `sequencing`
+ * (which defaults to `PlatformManaged`, matching `buildBatchOperation`) while
+ * the entries carry `AccountSequence`/`Ticket` — for example entries produced
+ * by `batchToCustodyInnerTransactions`.
+ *
+ * @param payload - The Batch payload passed to `dryRunBatch` / `proposeBatch`
+ * @throws {CustodyError} If the outer Batch and entries mix the two sequencing modes
+ */
+export function validateBatchSequencing(payload) {
+    const outerType = (payload.sequencing ?? { type: "PlatformManaged" }).type;
+    const slots = [
+        { label: "outer Batch", type: outerType },
+        ...payload.entries.map((entry, index) => ({
+            label: `entry ${index} (${entry.type})`,
+            type: entry.sequencing.type,
+        })),
+    ];
+    const platformManaged = slots.filter((slot) => slot.type === "PlatformManaged");
+    const explicit = slots.filter((slot) => slot.type !== "PlatformManaged");
+    if (platformManaged.length > 0 && explicit.length > 0) {
+        throw new CustodyError({
+            reason: "Batch sequencing must be either fully explicit (outer Batch and every entry " +
+                "AccountSequence or Ticket) or fully platform-managed (outer Batch and every entry " +
+                "PlatformManaged). Mixed configurations are not allowed. " +
+                `Platform-managed: ${platformManaged.map((slot) => slot.label).join(", ")}. ` +
+                `Explicit: ${explicit.map((slot) => slot.label).join(", ")}.`,
+        });
+    }
+}
+//# sourceMappingURL=xrpl.validators.js.map

package/dist/services/xrpl/xrpl.validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xrpl.validators.js","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA0B;IAChE,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAA;IAE1E,MAAM,KAAK,GAAG;QACZ,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,KAAK,EAAE,SAAS,KAAK,KAAK,KAAK,CAAC,IAAI,GAAG;YACvC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI;SAC5B,CAAC,CAAC;KACJ,CAAA;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAA;IAC/E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAA;IAExE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,YAAY,CAAC;YACrB,MAAM,EACJ,8EAA8E;gBAC9E,oFAAoF;gBACpF,0DAA0D;gBAC1D,qBAAqB,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7E,aAAa,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAChE,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@florent-uzio/custody",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "An SDK to interact with the Ripple Custody API",
   "keywords": [
     "Ripple Custody",