@florent-uzio/custody 2.1.0 → 2.3.0

package/dist/namespaces/intents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../src/namespaces/intents.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mCAAmC,EACxC,KAAK,oCAAoC,EACzC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AA8E3D,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc;+BAEzB,sBAAsB,KAAG,OAAO,CAAC,mBAAmB,CAAC;+BAGrD,sBAAsB,KAAG,OAAO,CAAC,mBAAmB,CAAC;8BAGtD,qBAAqB,KAAG,OAAO,CAAC,mBAAmB,CAAC;2BAI3D,wBAAwB,UACxB,0BAA0B,KACjC,OAAO,CAAC,kBAAkB,CAAC;4BAGpB,yBAAyB,UACzB,0BAA0B,KACjC,OAAO,CAAC,mBAAmB,CAAC;8BAEd,wBAAwB,KAAG,OAAO,CAAC,yBAAyB,CAAC;sCAIpE,mCAAmC,UACnC,oCAAoC,KAC3C,OAAO,CAAC,yBAAyB,CAAC;kCAG3B,wBAAwB,YACtB,uBAAuB,KAChC,OAAO,CAAC,sBAAsB,CAAC;EAErC"}
+{"version":3,"file":"intents.d.ts","sourceRoot":"","sources":["../../src/namespaces/intents.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,mCAAmC,EACxC,KAAK,oCAAoC,EACzC,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAgE3D,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc;+BAEzB,sBAAsB,KAAG,OAAO,CAAC,mBAAmB,CAAC;+BAGrD,sBAAsB,KAAG,OAAO,CAAC,mBAAmB,CAAC;8BAGtD,qBAAqB,KAAG,OAAO,CAAC,mBAAmB,CAAC;2BAI3D,wBAAwB,UACxB,0BAA0B,KACjC,OAAO,CAAC,kBAAkB,CAAC;4BAGpB,yBAAyB,UACzB,0BAA0B,KACjC,OAAO,CAAC,mBAAmB,CAAC;8BAEd,wBAAwB,KAAG,OAAO,CAAC,yBAAyB,CAAC;sCAIpE,mCAAmC,UACnC,oCAAoC,KAC3C,OAAO,CAAC,yBAAyB,CAAC;kCAG3B,wBAAwB,YACtB,uBAAuB,KAChC,OAAO,CAAC,sBAAsB,CAAC;EAErC"}

package/dist/namespaces/intents.js

@@ -3,56 +3,51 @@ import { sleep } from "../helpers/index.js";
 import { CustodyError } from "../models/index.js";
 import { TERMINAL_STATUSES, } from "../services/intents/intents.types.js";
 /**
- * Fetches an intent with retry logic for 404 errors.
- * Useful when the intent might not be immediately available after creation.
+ * Wait for an intent to reach a terminal status (Executed, Failed, Expired, or Rejected).
+ * Polls the intent status at regular intervals until it completes or max retries is reached.
+ *
+ * A 404 is treated as "not available yet" (e.g. when called immediately after proposing)
+ * and is retried within the same polling loop rather than aborting the wait.
  */
-async function getIntentWithRetry(t, params, maxRetries, intervalMs) {
-    let lastError;
+async function waitForExecution(t, params, options = {}) {
+    const { maxRetries = 10, intervalMs = 3000, onStatusCheck } = options;
+    let lastIntent;
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
         try {
-            return await t.get(URLs.getIntent, params);
+            const intent = await t.get(URLs.getIntent, params);
+            lastIntent = intent;
+            const status = intent.data.state.status;
+            onStatusCheck?.(status, attempt);
+            if (TERMINAL_STATUSES.includes(status)) {
+                return {
+                    status,
+                    isTerminal: true,
+                    isSuccess: status === "Executed",
+                    intent,
+                };
+            }
         }
         catch (error) {
-            if (error instanceof CustodyError && error.statusCode === 404) {
-                lastError = error;
-                if (attempt < maxRetries) {
-                    await sleep(intervalMs);
-                }
-                continue;
+            if (!(error instanceof CustodyError && error.statusCode === 404)) {
+                throw error;
             }
-            throw error;
-        }
-    }
-    throw lastError;
-}
-/**
- * Wait for an intent to reach a terminal status (Executed, Failed, Expired, or Rejected).
- * Polls the intent status at regular intervals until it completes or max retries is reached.
- */
-async function waitForExecution(t, params, options = {}) {
-    const { maxRetries = 10, intervalMs = 3000, notFoundRetries = 3, notFoundIntervalMs = 1000, onStatusCheck, } = options;
-    for (let attempt = 1; attempt <= maxRetries; attempt++) {
-        const intent = await getIntentWithRetry(t, params, notFoundRetries, notFoundIntervalMs);
-        const status = intent.data.state.status;
-        onStatusCheck?.(status, attempt);
-        if (TERMINAL_STATUSES.includes(status)) {
-            return {
-                status,
-                isTerminal: true,
-                isSuccess: status === "Executed",
-                intent,
-            };
+            // 404 → the intent is not available yet, keep polling.
         }
         if (attempt < maxRetries) {
             await sleep(intervalMs);
         }
     }
-    const finalIntent = await getIntentWithRetry(t, params, notFoundRetries, notFoundIntervalMs);
+    // Retries exhausted. If the intent never materialized, surface that as a 404.
+    if (!lastIntent) {
+        throw new CustodyError({ reason: `Intent ${params.intentId} not found after ${maxRetries} attempts` }, 404);
+    }
+    // The loop returns early on any terminal status, so the last observed intent is
+    // necessarily non-terminal here.
     return {
-        status: finalIntent.data.state.status,
+        status: lastIntent.data.state.status,
         isTerminal: false,
         isSuccess: false,
-        intent: finalIntent,
+        intent: lastIntent,
     };
 }
 export function createIntents(t) {

package/dist/namespaces/intents.js.map

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

package/dist/ripple-custody.d.ts

@@ -2,7 +2,7 @@ import type { SubmittableTransaction } from "xrpl";
 import { createAccounts, createChannels, createDomains, createEndpoints, createEvents, createGenesis, createIntents, createLedgers, createPolicies, createRequests, createTickers, createTransactions, createUserInvitations, createUsers, createVaults } from "./namespaces/index.js";
 import type { RippleCustodyClientOptions } from "./ripple-custody.types.js";
 import type { Core_IntentResponse } from "./services/intents/intents.types.js";
-import { type Core_XrplOperation, type RawSignAndWaitOptions, type RawSignAndWaitResult, type XrplIntentOptions } from "./services/xrpl/index.js";
+import { type BatchPayloadInput, type Core_ApiBatchSigningData, type Core_BatchSigner, type Core_XrplOperation, type GetBatchSignatureParams, type RawSignAndWaitOptions, type RawSignAndWaitResult, type SignBatchPayloadHandle, type SignBatchPayloadOptions, type SignBatchPayloadResult, type WaitForSignatureOptions, type XrplIntentOptions } from "./services/xrpl/index.js";
 export declare class RippleCustody {
     private readonly apiService;
     private readonly authService;
@@ -67,20 +67,65 @@ export declare class RippleCustody {
          */
         rawSignAndWait: (xrplTransaction: SubmittableTransaction, options?: RawSignAndWaitOptions) => Promise<RawSignAndWaitResult>;
         /**
-         * Proposes a raw sign intent for a Batch transaction envelope for a single inner account.
-         * @param batch - The autofilled Batch transaction
-         * @param signerAddress - The XRPL address of the inner account to sign for
-         * @param options - Optional configuration for the raw sign intent
-         * @returns The proposed intent response
+         * Step 1 of the XLS-56 Batch flow — dry-runs a Batch and returns the
+         * canonical signing data. Each participant signs `signingPayload` with
+         * their own XRPL key; collect signatures and pass them to `proposeBatch`.
+         *
+         * @param payload - Submitter, execution mode, and inner entries
+         * @param options - Optional configuration for the dry-run intent
+         * @returns The batch signing data (signingPayload, hash, resolved transactions)
          */
+        dryRunBatch: (payload: BatchPayloadInput, options?: XrplIntentOptions) => Promise<Core_ApiBatchSigningData>;
         /**
-         * Signs a Batch transaction envelope for a single inner account and waits
-         * for the manifest signature. Call once per inner account.
-         * @param batch - The autofilled Batch transaction
+         * Step 2 of the XLS-56 Batch flow — signs the `signingPayload` from a dry
+         * run for an inner account managed by this custody instance and waits for
+         * the manifest signature. Call once per locally-managed signer.
+         *
+         * @param signingPayload - Hex-encoded payload from `dryRunBatch`
          * @param signerAddress - The XRPL address of the inner account to sign for
          * @param options - Optional configuration for the raw sign intent and polling
-         * @returns The signature and signing public key in uppercase hex
+         * @returns Signature, public key, and pre-built BatchSigner shapes
+         */
+        signBatchPayloadAndWait: (signingPayload: string, signerAddress: string, options?: SignBatchPayloadOptions) => Promise<SignBatchPayloadResult>;
+        /**
+         * Step 2 of the XLS-56 Batch flow (non-blocking) — proposes the raw sign
+         * intent for an inner account managed by this custody instance and returns
+         * immediately, without waiting for the manifest signature.
+         *
+         * Use when the operator approves signatures out-of-band: persist the
+         * returned handle and pass it to `getBatchSignature` later to fetch the
+         * signature once available.
+         *
+         * @param signingPayload - Hex-encoded payload from `dryRunBatch`
+         * @param signerAddress - The XRPL address of the inner account to sign for
+         * @param options - Optional configuration for the raw sign intent
+         * @returns A handle with the manifest ID and fields needed to retrieve the signature
+         */
+        signBatchPayload: (signingPayload: string, signerAddress: string, options?: SignBatchPayloadOptions) => Promise<SignBatchPayloadHandle>;
+        /**
+         * Retrieves the signature for a payload proposed via `signBatchPayload`,
+         * building the BatchSigner shapes when available.
+         *
+         * Performs a single fetch by default; returns `undefined` if the operator
+         * has not approved the signature yet. Pass `maxRetries`/`intervalMs` to opt
+         * into light polling.
+         *
+         * @param params - Fields from the `signBatchPayload` handle (a handle may be passed directly)
+         * @param options - Optional polling configuration (defaults to a single attempt)
+         * @returns Signature and BatchSigner shapes, or `undefined` if not yet signed
+         */
+        getBatchSignature: (params: GetBatchSignatureParams, options?: WaitForSignatureOptions) => Promise<SignBatchPayloadResult | undefined>;
+        /**
+         * Step 3 of the XLS-56 Batch flow — submits the Batch with collected
+         * `batchSigners`. Reuse `options.payloadId`/`options.requestId` if you
+         * need referential identity with the dry-run.
+         *
+         * @param payload - Same submitter, execution mode, and entries as the dry-run
+         * @param batchSigners - Signatures collected in Step 2
+         * @param options - Optional configuration for the intent
+         * @returns The proposed intent response
          */
+        proposeBatch: (payload: BatchPayloadInput, batchSigners: Core_BatchSigner[], options?: XrplIntentOptions) => Promise<Core_IntentResponse>;
         /**
          * Get the compressed secp256k1 public key for an XRPL account.
          * @param params - The domain ID and account ID

package/dist/ripple-custody.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ripple-custody.d.ts","sourceRoot":"","sources":["../src/ripple-custody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,MAAM,CAAA;AAClD,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACb,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAG3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAA;AAC9E,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAA;AAGjC,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAG1C,OAAO,CAAC,YAAY,CAAC,CAAa;IAElC,OAAO,KAAK,WAAW,GAEtB;IAGD,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAC3D,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzD,SAAgB,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;IAC7D,SAAgB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;IACvD,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzD,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzD,SAAgB,YAAY,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;IACnE,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAC3D,SAAgB,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;IACrD,SAAgB,eAAe,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;IACzE,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzD,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IACzD,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAC3D,SAAgB,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;IACvD,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;gBAE/C,OAAO,EAAE,0BAA0B;IAmC/C,SAAgB,IAAI;QAClB;;WAEG;;QAGH;;WAEG;;MAEJ;IAGD,SAAgB,IAAI;QAClB;;;;;;;;;;WAUG;gCAEO;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,kBAAkB,CAAA;SAAE,YAChD,iBAAiB,KAC1B,OAAO,CAAC,mBAAmB,CAAC;QAE/B;;;;;WAKG;mCAEgB,sBAAsB,YAC7B,iBAAiB,KAC1B,OAAO,CAAC,mBAAmB,CAAC;QAE/B;;;;;;WAMG;0CAEgB,sBAAsB,YAC7B,qBAAqB,KAC9B,OAAO,CAAC,oBAAoB,CAAC;QAEhC;;;;;;WAMG;QAQH;;;;;;;WAOG;QAQH;;;;WAIG;+BAC0B;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,KAAG,OAAO,CAAC,MAAM,CAAC;MAEvF;CACF"}
+{"version":3,"file":"ripple-custody.d.ts","sourceRoot":"","sources":["../src/ripple-custody.ts"],"names":[],"mappings":"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"}

package/dist/ripple-custody.js

@@ -101,32 +101,65 @@ export class RippleCustody {
          */
         rawSignAndWait: async (xrplTransaction, options) => this.xrplService.rawSignAndWait(xrplTransaction, options),
         /**
-         * Proposes a raw sign intent for a Batch transaction envelope for a single inner account.
-         * @param batch - The autofilled Batch transaction
-         * @param signerAddress - The XRPL address of the inner account to sign for
-         * @param options - Optional configuration for the raw sign intent
-         * @returns The proposed intent response
+         * Step 1 of the XLS-56 Batch flow — dry-runs a Batch and returns the
+         * canonical signing data. Each participant signs `signingPayload` with
+         * their own XRPL key; collect signatures and pass them to `proposeBatch`.
+         *
+         * @param payload - Submitter, execution mode, and inner entries
+         * @param options - Optional configuration for the dry-run intent
+         * @returns The batch signing data (signingPayload, hash, resolved transactions)
          */
-        // rawSignInnerBatch: async (
-        //   batch: Batch,
-        //   signerAddress: string,
-        //   options?: RawSignInnerBatchOptions,
-        // ): Promise<Core_IntentResponse> =>
-        //   this.xrplService.rawSignInnerBatch(batch, signerAddress, options),
+        dryRunBatch: async (payload, options) => this.xrplService.dryRunBatch(payload, options),
         /**
-         * Signs a Batch transaction envelope for a single inner account and waits
-         * for the manifest signature. Call once per inner account.
-         * @param batch - The autofilled Batch transaction
+         * Step 2 of the XLS-56 Batch flow — signs the `signingPayload` from a dry
+         * run for an inner account managed by this custody instance and waits for
+         * the manifest signature. Call once per locally-managed signer.
+         *
+         * @param signingPayload - Hex-encoded payload from `dryRunBatch`
          * @param signerAddress - The XRPL address of the inner account to sign for
          * @param options - Optional configuration for the raw sign intent and polling
-         * @returns The signature and signing public key in uppercase hex
+         * @returns Signature, public key, and pre-built BatchSigner shapes
+         */
+        signBatchPayloadAndWait: async (signingPayload, signerAddress, options) => this.xrplService.signBatchPayloadAndWait(signingPayload, signerAddress, options),
+        /**
+         * Step 2 of the XLS-56 Batch flow (non-blocking) — proposes the raw sign
+         * intent for an inner account managed by this custody instance and returns
+         * immediately, without waiting for the manifest signature.
+         *
+         * Use when the operator approves signatures out-of-band: persist the
+         * returned handle and pass it to `getBatchSignature` later to fetch the
+         * signature once available.
+         *
+         * @param signingPayload - Hex-encoded payload from `dryRunBatch`
+         * @param signerAddress - The XRPL address of the inner account to sign for
+         * @param options - Optional configuration for the raw sign intent
+         * @returns A handle with the manifest ID and fields needed to retrieve the signature
+         */
+        signBatchPayload: async (signingPayload, signerAddress, options) => this.xrplService.signBatchPayload(signingPayload, signerAddress, options),
+        /**
+         * Retrieves the signature for a payload proposed via `signBatchPayload`,
+         * building the BatchSigner shapes when available.
+         *
+         * Performs a single fetch by default; returns `undefined` if the operator
+         * has not approved the signature yet. Pass `maxRetries`/`intervalMs` to opt
+         * into light polling.
+         *
+         * @param params - Fields from the `signBatchPayload` handle (a handle may be passed directly)
+         * @param options - Optional polling configuration (defaults to a single attempt)
+         * @returns Signature and BatchSigner shapes, or `undefined` if not yet signed
+         */
+        getBatchSignature: async (params, options) => this.xrplService.getBatchSignature(params, options),
+        /**
+         * Step 3 of the XLS-56 Batch flow — submits the Batch with collected
+         * `batchSigners`. Reuse `options.payloadId`/`options.requestId` if you
+         * need referential identity with the dry-run.
+         *
+         * @param payload - Same submitter, execution mode, and entries as the dry-run
+         * @param batchSigners - Signatures collected in Step 2
+         * @param options - Optional configuration for the intent
+         * @returns The proposed intent response
          */
-        // rawSignInnerBatchAndWait: async (
-        //   batch: Batch,
-        //   signerAddress: string,
-        //   options?: RawSignInnerBatchOptions,
-        // ): Promise<RawSignInnerBatchAndWaitResult> =>
-        //   this.xrplService.rawSignInnerBatchAndWait(batch, signerAddress, options),
+        proposeBatch: async (payload, batchSigners, options) => this.xrplService.proposeBatch(payload, batchSigners, options),
         /**
          * Get the compressed secp256k1 public key for an XRPL account.
          * @param params - The domain ID and account ID

package/dist/ripple-custody.js.map

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

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

@@ -9,19 +9,14 @@ export declare const PENDING_STATUSES: Core_IntentStatus[];
  * Options for waiting for intent execution
  */
 export type WaitForExecutionOptions = {
-    /** Maximum number of polling attempts (default: 10) */
+    /**
+     * Maximum number of polling attempts (default: 10). Also bounds how long a
+     * not-yet-available (404) intent is waited for, since 404s are retried within
+     * the same loop.
+     */
     maxRetries?: number;
     /** Interval between polling attempts in milliseconds (default: 3000) */
     intervalMs?: number;
-    /**
-     * Maximum number of retries when the intent is not found (404).
-     * Useful when calling immediately after proposeIntent. (default: 3)
-     */
-    notFoundRetries?: number;
-    /**
-     * Interval between retries when the intent is not found in milliseconds (default: 1000)
-     */
-    notFoundIntervalMs?: number;
     /**
      * Callback function called on each status check.
      * Useful for logging or updating UI.

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

@@ -1 +1 @@
-{"version":3,"file":"intents.types.d.ts","sourceRoot":"","sources":["../../../src/services/intents/intents.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAG5E,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAA;AAE1E,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAAkD,CAAA;AAEnG,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAAsC,CAAA;AAEtF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACrE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,qCAAqC;IACrC,MAAM,EAAE,iBAAiB,CAAA;IACzB,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,MAAM,EAAE,kBAAkB,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC,CAChF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC,CAChF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,CAC/E,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAA;AAG9E,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACpF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAG5E,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACtF,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;AAGxF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAA;AACxF,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAA;AAG1F,MAAM,MAAM,mCAAmC,GAC7C,UAAU,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvD,MAAM,MAAM,oCAAoC,GAC9C,UAAU,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;AACxD,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"intents.types.d.ts","sourceRoot":"","sources":["../../../src/services/intents/intents.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAG5E,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAA;AAE1E,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,iBAAiB,EAAkD,CAAA;AAEnG,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,EAAsC,CAAA;AAEtF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACrE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,qCAAqC;IACrC,MAAM,EAAE,iBAAiB,CAAA;IACzB,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,MAAM,EAAE,kBAAkB,CAAA;CAC3B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC,CAChF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC,CAChF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,iBAAiB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,CAC/E,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,qBAAqB,CAAC,CAAA;AAG9E,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACpF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAA;AAG5E,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACtF,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;AAGxF,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,0BAA0B,CAAC,CAAA;AACxF,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAA;AAG1F,MAAM,MAAM,mCAAmC,GAC7C,UAAU,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AACvD,MAAM,MAAM,oCAAoC,GAC9C,UAAU,CAAC,mBAAmB,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAA;AACxD,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,2BAA2B,CAAC,CAAA"}

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

@@ -1,3 +1,4 @@
+export { batchSignersToCustodyBatchSigners, batchToCustodyBatchPayload, batchToCustodyInnerTransactions, } from "./xrpl.adapters.js";
 export { createHttpPorts } from "./xrpl.http-adapters.js";
 export type { XrplPorts } from "./xrpl.ports.js";
 export * from "./xrpl.service.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}

package/dist/services/xrpl/index.js

@@ -1,7 +1,4 @@
-// export {
-//   batchSignersToCustodyBatchSigners,
-//   rawTransactionsToInnerTransactions,
-// } from "./xrpl.adapters.js"
+export { batchSignersToCustodyBatchSigners, batchToCustodyBatchPayload, batchToCustodyInnerTransactions, } from "./xrpl.adapters.js";
 export { createHttpPorts } from "./xrpl.http-adapters.js";
 export * from "./xrpl.service.js";
 export * from "./xrpl.types.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/xrpl/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,uCAAuC;AACvC,wCAAwC;AACxC,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/xrpl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,0BAA0B,EAC1B,+BAA+B,GAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}

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

@@ -1,13 +1,31 @@
-export {};
+import { type Batch, type BatchSigner } from "xrpl";
+import type { BatchPayloadInput, CustodyBatchSigner, CustodyInnerTransaction } from "./xrpl.types.js";
 /**
  * Converts an XRPL SDK BatchSigners array (from a signed Batch transaction)
  * to the batchSigners format required by the Ripple Custody API.
  */
+export declare const batchSignersToCustodyBatchSigners: (batchSigners: BatchSigner[]) => CustodyBatchSigner[];
 /**
- * Converts an XRPL SDK Batch.RawTransactions array to the innerTransactions
- * format required by the Ripple Custody API.
+ * Converts an autofilled xrpl.js Batch into a `BatchPayloadInput` for
+ * `dryRunBatch` / `proposeBatch`.
  *
- * Supported transaction types: Payment, OfferCreate, TrustSet, AccountSet, TicketCreate.
- * Throws for any other type.
+ * - `Flags` is required and must set exactly one execution-mode flag
+ *   (`tfAllOrNothing` / `tfOnlyOne` / `tfUntilFailure` / `tfIndependent`)
+ * - When `Sequence` is present on the outer Batch, it is mapped to
+ *   `{ type: "AccountSequence", value: Sequence }`; otherwise `sequencing`
+ *   is omitted so the service default `{ type: "PlatformManaged" }` applies
+ * - `LastLedgerSequence` is passed through when present
+ * - `BatchSigners` on the input is ignored — collect signatures separately
+ *   and pass them to `proposeBatch`
  */
+export declare const batchToCustodyBatchPayload: (batch: Batch) => BatchPayloadInput;
+/**
+ * Converts an xrpl.js Batch transaction to the inner transactions array
+ * required by the Ripple Custody API.
+ *
+ * Each inner transaction is emitted as a `SubmitterOperation` when its
+ * `Account` matches the outer `Batch.Account` (the submitter), and as a
+ * `ParticipantOperation` otherwise.
+ */
+export declare const batchToCustodyInnerTransactions: (batch: Pick<Batch, "Account" | "RawTransactions">) => CustodyInnerTransaction[];
 //# sourceMappingURL=xrpl.adapters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"xrpl.adapters.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.adapters.ts"],"names":[],"mappings":";AAiRA;;;GAGG;AAWH;;;;;;GAMG"}
+{"version":3,"file":"xrpl.adapters.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EAEV,KAAK,WAAW,EAOjB,MAAM,MAAM,CAAA;AAGb,OAAO,KAAK,EACV,iBAAiB,EAIjB,kBAAkB,EAClB,uBAAuB,EAGxB,MAAM,iBAAiB,CAAA;AAkQxB;;;GAGG;AACH,eAAO,MAAM,iCAAiC,GAC5C,cAAc,WAAW,EAAE,KAC1B,kBAAkB,EASpB,CAAA;AAyCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,0BAA0B,GAAI,OAAO,KAAK,KAAG,iBAYzD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,GAC1C,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,iBAAiB,CAAC,KAChD,uBAAuB,EAmBzB,CAAA"}