@florent-uzio/custody 2.2.0 → 2.4.0

package/dist/services/xrpl/xrpl.crypto.js

@@ -0,0 +1,19 @@
+import { createPublicKey } from "crypto";
+/**
+ * Compresses a base64-encoded SPKI/DER secp256k1 public key to its compressed hex form.
+ * Uses Node.js built-in crypto via JWK export to extract the raw EC point coordinates.
+ */
+export function compressPublicKey(base64PublicKey) {
+    const publicKey = createPublicKey({
+        key: Buffer.from(base64PublicKey, "base64"),
+        format: "der",
+        type: "spki",
+    });
+    const jwk = publicKey.export({ format: "jwk" });
+    const x = Buffer.from(jwk.x, "base64url");
+    const y = Buffer.from(jwk.y, "base64url");
+    const lastByte = y[y.length - 1];
+    const prefix = lastByte % 2 === 0 ? "02" : "03";
+    return (prefix + x.toString("hex")).toUpperCase();
+}
+//# sourceMappingURL=xrpl.crypto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xrpl.crypto.js","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.crypto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAExC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAAuB;IACvD,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;QAC3C,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,MAAM;KACb,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,WAAW,CAAC,CAAA;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAE,EAAE,WAAW,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;IACjC,MAAM,MAAM,GAAG,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IAC/C,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;AACnD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"xrpl.http-adapters.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.http-adapters.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAI9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CAsCpE"}
+{"version":3,"file":"xrpl.http-adapters.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.http-adapters.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAS9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,CA4CpE"}

package/dist/services/xrpl/xrpl.http-adapters.js

@@ -31,6 +31,11 @@ export function createHttpPorts(transport) {
         submitIntent(body) {
             return transport.post(URLs.intents, body);
         },
+        dryRunIntent(body) {
+            return transport.post(URLs.intentsDryRun, body, undefined, {
+                sign: false,
+            });
+        },
         getManifest(domainId, accountId, manifestId) {
             return transport.get(URLs.accountManifest, {
                 domainId,

package/dist/services/xrpl/xrpl.http-adapters.js.map

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

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

@@ -1,6 +1,6 @@
 import type { XrplLedgerId } from "../../models/ledger-ids.js";
 import type { Core_ApiAccount, Core_ApiManifest } from "../accounts/accounts.types.js";
-import type { Core_IntentResponse, Core_ProposeIntentBody } from "../intents/intents.types.js";
+import type { Core_IntentDryRunRequest, Core_IntentDryRunResponse, Core_IntentResponse, Core_ProposeIntentBody } from "../intents/intents.types.js";
 import type { IntentContext } from "./xrpl.types.js";
 /**
  * I/O ports for XrplService.
@@ -22,6 +22,12 @@ export interface XrplPorts {
      * Wraps POST /v1/intents.
      */
     submitIntent(body: Core_ProposeIntentBody): Promise<Core_IntentResponse>;
+    /**
+     * Dry-runs an intent and returns the resolved estimate (including
+     * `batchSigningData` for Batch operations).
+     * Wraps POST /v1/intents/dry-run.
+     */
+    dryRunIntent(body: Core_IntentDryRunRequest): Promise<Core_IntentDryRunResponse>;
     /**
      * Retrieves a manifest for polling signature availability.
      * Wraps GET /v1/domains/{domainId}/accounts/{accountId}/manifests/{manifestId}.

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

@@ -1 +1 @@
-{"version":3,"file":"xrpl.ports.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GACpD,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAExE;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE/F;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAC1E"}
+{"version":3,"file":"xrpl.ports.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACtF,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GACpD,OAAO,CAAC,aAAa,CAAC,CAAA;IAEzB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAExE;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAA;IAEhF;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE/F;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAC1E"}

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

@@ -1,7 +1,7 @@
 import { type SubmittableTransaction } from "xrpl";
 import type { Core_IntentResponse } from "../intents/intents.types.js";
 import type { XrplPorts } from "./xrpl.ports.js";
-import type { Core_XrplOperation, RawSignAndWaitOptions, RawSignAndWaitResult, XrplIntentOptions } from "./xrpl.types.js";
+import type { BatchPayloadInput, Core_ApiBatchSigningData, Core_BatchSigner, Core_XrplOperation, GetBatchSignatureParams, RawSignAndWaitOptions, RawSignAndWaitResult, SignBatchPayloadHandle, SignBatchPayloadOptions, SignBatchPayloadResult, WaitForSignatureOptions, XrplIntentOptions } from "./xrpl.types.js";
 export declare class XrplService {
     private readonly ports;
     constructor(ports: XrplPorts);
@@ -57,68 +57,111 @@ export declare class XrplService {
      */
     rawSignAndWait(xrplTransaction: SubmittableTransaction, options?: RawSignAndWaitOptions): Promise<RawSignAndWaitResult>;
     /**
-     * Proposes a raw sign intent for a Batch transaction envelope for a single
-     * inner account. The batch envelope (`flags` + all inner transaction hashes)
-     * is encoded using `encodeForSigningBatch` and signed with the key of the
-     * specified `signerAddress`.
+     * Step 1 of the XLS-56 Batch flow — dry-runs a Batch transaction order and
+     * returns the canonical signing data. Each participant must sign
+     * `signingPayload` with their own XRPL key; collect those signatures and pass
+     * them to `proposeBatch` (Step 3).
      *
-     * All signers sign the same envelope data. Call this once per inner account
-     * that is managed by this custody instance.
+     * Use `signBatchPayloadAndWait` to sign for inner accounts managed by this
+     * custody instance.
      *
-     * @param batch - The autofilled Batch transaction (with all inner transactions)
-     * @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
-     * @throws {CustodyError} If signerAddress is not in the batch, or the account is not found
+     * @param payload - Submitter address, execution mode, and inner entries
+     * @param options - Optional configuration for the dry-run intent
+     * @returns The batch signing data (`signingPayload`, `signingPayloadHash`, resolved transactions)
+     * @throws {CustodyError} If the dry run fails or does not return batch signing data
      */
+    dryRunBatch(payload: BatchPayloadInput, options?: XrplIntentOptions): Promise<Core_ApiBatchSigningData>;
     /**
-     * Signs a Batch transaction envelope for a single inner account and waits
-     * for the manifest signature.
+     * Step 2 of the XLS-56 Batch flow — signs the `signingPayload` returned by
+     * `dryRunBatch` for a single inner account managed by this custody instance,
+     * and waits for the manifest signature.
      *
-     * All signers sign the same envelope (`flags` + all inner transaction hashes).
-     * Call this method once per inner account managed by this custody instance.
-     * Inner accounts on other custody instances sign independently with their own SDK.
+     * Inner accounts on other custody instances (or non-custody participants)
+     * sign independently with their own keys.
      *
-     * @param batch - The autofilled Batch transaction (with all inner transactions)
-     * @param signerAddress - The XRPL address of the inner account to sign for
+     * @param signingPayload - Hex-encoded `signingPayload` from `dryRunBatch` response
+     * @param signerAddress - 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
-     * @throws {CustodyError} If signerAddress is not in the batch, the account is not found,
-     *   or the manifest signature is not available after maximum retries
+     * @returns The signature, signing public key, and pre-built BatchSigner shapes
+     * @throws {CustodyError} If the signer account is not found, or the signature is not
+     *   available after maximum retries
      */
+    signBatchPayloadAndWait(signingPayload: string, signerAddress: string, options?: SignBatchPayloadOptions): Promise<SignBatchPayloadResult>;
     /**
-     * Resolves the intent context for an inner batch signer.
-     * When `accountId` and `ledgerId` are provided in options, skips the address lookup.
-     * @private
+     * Step 2 of the XLS-56 Batch flow (non-blocking variant) — proposes the raw
+     * sign intent for the `signingPayload` returned by `dryRunBatch` for a single
+     * inner account managed by this custody instance, then returns immediately
+     * without waiting for the manifest signature.
+     *
+     * Use this when the custody instance operator approves signatures
+     * out-of-band: persist the returned `SignBatchPayloadHandle` and pass it to
+     * `getBatchSignature` later (possibly from another process) to fetch the
+     * signature once it is available.
+     *
+     * @param signingPayload - Hex-encoded `signingPayload` from `dryRunBatch` response
+     * @param signerAddress - 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 the fields needed to retrieve the signature
+     * @throws {CustodyError} If the signer account is not found
      */
+    signBatchPayload(signingPayload: string, signerAddress: string, options?: SignBatchPayloadOptions): Promise<SignBatchPayloadHandle>;
     /**
-     * Validates that the signer address is involved in at least one inner transaction.
-     * @private
+     * Retrieves the signature for a payload proposed via `signBatchPayload`,
+     * building the BatchSigner shapes when it is available.
+     *
+     * Performs a single fetch by default (`maxRetries: 1`); the operator may not
+     * have approved the signature yet, in which case `undefined` is returned and
+     * the caller decides when to retry. Pass `maxRetries`/`intervalMs` to opt into
+     * light polling.
+     *
+     * @param params - Fields from the `SignBatchPayloadHandle` (a handle may be passed directly)
+     * @param options - Optional polling configuration (defaults to a single attempt)
+     * @returns The signature and BatchSigner shapes, or `undefined` if not yet signed
+     * @throws {CustodyError} On any non-404 error fetching the manifest
      */
-    private validateBatchSigner;
+    getBatchSignature(params: GetBatchSignatureParams, options?: WaitForSignatureOptions): Promise<SignBatchPayloadResult | undefined>;
     /**
-     * Encodes a Batch transaction envelope for signing.
-     * Computes txIDs from inner transactions and encodes with `encodeForSigningBatch`.
+     * Step 3 of the XLS-56 Batch flow — submits the Batch as a real intent with
+     * collected `batchSigners`. The payload must match the one used for
+     * `dryRunBatch`; reuse `options.payloadId` and `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 (one per participant)
+     * @param options - Optional configuration for the intent
+     * @returns The proposed intent response
+     * @throws {CustodyError} If validation fails or the submitter account is not found
+     */
+    proposeBatch(payload: BatchPayloadInput, batchSigners: Core_BatchSigner[], options?: XrplIntentOptions): Promise<Core_IntentResponse>;
+    /**
+     * Resolves the intent context for an inner-batch signer. Skips the address
+     * lookup when `accountId` and `ledgerId` are provided.
      * @private
      */
-    private encodeBatchForSigning;
+    private resolveSignerContext;
     /**
      * Proposes a raw sign intent with base64-encoded bytes.
-     * Shared by rawSign, rawSignAndWait, and signBytesAndWait.
+     * Shared by rawSign, rawSignAndWait, and signBatchPayloadAndWait.
      * @private
      */
     private proposeRawSignIntent;
     /**
      * Polls the manifest until a signature is available, then returns it as uppercase hex.
-     * Handles both the manifest not existing yet (404) and the manifest existing
-     * but not yet having a signature.
+     * Throws if the signature is still unavailable after the maximum retries.
      * @private
      */
     private waitForManifestSignature;
     /**
-     * Builds an XRPL intent body.
+     * Polls the manifest for a signature, returning it as uppercase hex once
+     * available, or `undefined` if still unavailable after the maximum retries.
+     * @private
+     */
+    private pollManifestSignature;
+    /**
+     * Fetches the manifest once and returns its signature as uppercase hex, or
+     * `undefined` if the manifest does not exist yet (404) or has no signature.
      * @private
      */
-    private buildTransactionIntent;
+    private fetchManifestSignature;
 }
 //# sourceMappingURL=xrpl.service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"xrpl.service.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,sBAAsB,EAC5B,MAAM,MAAM,CAAA;AAIb,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,6BAA6B,CAAA;AAC9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAEV,kBAAkB,EAElB,qBAAqB,EACrB,oBAAoB,EAEpB,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAExB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAE7C;;;;;;;;;;;;;;OAcG;IACU,aAAa,CACxB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,kBAAkB,CAAA;KAAE,EAC1D,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAe/B;;;;;;OAMG;IACU,YAAY,CAAC,EACxB,QAAQ,EACR,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnB;;;;;;OAMG;IACU,OAAO,CAClB,eAAe,EAAE,sBAAsB,EACvC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAa/B;;;;;;;;;;;OAWG;IACU,cAAc,CACzB,eAAe,EAAE,sBAAsB,EACvC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAwChC;;;;;;;;;;;;;;OAcG;IAgBH;;;;;;;;;;;;;;OAcG;IA4CH;;;;OAIG;IAwBH;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;OAIG;YACW,oBAAoB;IAuClC;;;;;OAKG;YACW,wBAAwB;IAkCtC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAwC/B"}
+{"version":3,"file":"xrpl.service.d.ts","sourceRoot":"","sources":["../../../src/services/xrpl/xrpl.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,MAAM,CAAA;AAIpF,OAAO,KAAK,EAAE,mBAAmB,EAA0B,MAAM,6BAA6B,CAAA;AAQ9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EAEvB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAGxB,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAE7C;;;;;;;;;;;;;;OAcG;IACU,aAAa,CACxB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,kBAAkB,CAAA;KAAE,EAC1D,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAe/B;;;;;;OAMG;IACU,YAAY,CAAC,EACxB,QAAQ,EACR,SAAS,GACV,EAAE;QACD,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnB;;;;;;OAMG;IACU,OAAO,CAClB,eAAe,EAAE,sBAAsB,EACvC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAa/B;;;;;;;;;;;OAWG;IACU,cAAc,CACzB,eAAe,EAAE,sBAAsB,EACvC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC;IAwChC;;;;;;;;;;;;;OAaG;IACU,WAAW,CACtB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,wBAAwB,CAAC;IA+BpC;;;;;;;;;;;;;;OAcG;IACU,uBAAuB,CAClC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC;IAalC;;;;;;;;;;;;;;;;OAgBG;IACU,gBAAgB,CAC3B,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC;IA8BlC;;;;;;;;;;;;;OAaG;IACU,iBAAiB,CAC5B,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAe9C;;;;;;;;;;;OAWG;IACU,YAAY,CACvB,OAAO,EAAE,iBAAiB,EAC1B,YAAY,EAAE,gBAAgB,EAAE,EAChC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,mBAAmB,CAAC;IAc/B;;;;OAIG;YACW,oBAAoB;IAmBlC;;;;OAIG;YACW,oBAAoB;IAwClC;;;;OAIG;YACW,wBAAwB;IAiBtC;;;;OAIG;YACW,qBAAqB;IAwBnC;;;;OAIG;YACW,sBAAsB;CAoBrC"}