@hypermid/sdk 1.2.0

package/dist/execution.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Execution lifecycle management — high-level helpers that manage the
+ * full swap flow: quote → execute → poll status until completion.
+ *
+ * Similar to LI.FI SDK's execution tracking and Near Intents SDK's
+ * status polling, but unified across both providers.
+ */
+import type { HyperMid } from "./client.js";
+import type { ExecuteParams, ExecuteResponse, LiFiExecuteResponse, NIExecuteResponse, DepositStatusResponse, StatusResponse, QuoteResponse } from "./types.js";
+export type ExecutionStatus = "QUOTE" | "EXECUTING" | "WAITING_DEPOSIT" | "DEPOSIT_SUBMITTED" | "PROCESSING" | "SUCCESS" | "FAILED" | "REFUNDED";
+export interface ExecutionUpdate {
+    /** Current execution status */
+    status: ExecutionStatus;
+    /** The provider handling this swap */
+    provider: "lifi" | "near-intents" | "superswap";
+    /** The execute response (available after EXECUTING) */
+    executeResponse?: ExecuteResponse;
+    /** The deposit status (Near Intents only, available during polling) */
+    depositStatus?: DepositStatusResponse;
+    /** LI.FI status response (available during polling) */
+    lifiStatus?: StatusResponse;
+    /** Error message if FAILED */
+    error?: string;
+}
+export interface ExecutionHooks {
+    /** Called on every status change */
+    onStatusChange?: (update: ExecutionUpdate) => void;
+    /** Called when execute response is received (provider-specific) */
+    onExecute?: (response: ExecuteResponse) => void;
+    /**
+     * Called when LI.FI transactionRequest is ready — you MUST sign and broadcast it.
+     * Return the transaction hash after broadcasting.
+     *
+     * If not provided, the execution will stop after returning the transactionRequest
+     * and you'll need to handle signing yourself.
+     */
+    onTransactionRequest?: (response: LiFiExecuteResponse) => Promise<string>;
+    /**
+     * Called when Near Intents deposit address is ready and depositMode is "wallet".
+     * You MUST send tokens to the deposit address and return the tx hash.
+     *
+     * If not provided for wallet-mode deposits, the execution will stop after
+     * returning the deposit address.
+     */
+    onDepositRequired?: (response: NIExecuteResponse) => Promise<string>;
+    /** Called on each poll iteration with the latest status */
+    onPoll?: (status: DepositStatusResponse | StatusResponse) => void;
+}
+export interface ExecutionConfig {
+    /** Polling interval in ms (default: 5000) */
+    pollIntervalMs?: number;
+    /** Maximum time to wait for completion in ms (default: 600000 = 10 min) */
+    maxWaitMs?: number;
+    /** Maximum number of poll attempts (default: unlimited) */
+    maxPolls?: number;
+}
+/**
+ * Poll Near Intents deposit/swap status until a terminal state is reached.
+ *
+ * @example
+ * ```ts
+ * const finalStatus = await waitForDepositCompletion(hm, {
+ *   depositAddress: "0x...",
+ * }, {
+ *   onPoll: (status) => console.log("Status:", status.status),
+ * });
+ * ```
+ */
+export declare function waitForDepositCompletion(client: HyperMid, params: {
+    depositAddress: string;
+    depositMemo?: string;
+}, options?: ExecutionConfig & {
+    onPoll?: (status: DepositStatusResponse) => void;
+}): Promise<DepositStatusResponse>;
+/**
+ * Poll LI.FI swap status until a terminal state is reached.
+ *
+ * @example
+ * ```ts
+ * const finalStatus = await waitForLiFiCompletion(hm, {
+ *   txHash: "0x...",
+ *   fromChain: 1,
+ *   toChain: 42161,
+ * });
+ * ```
+ */
+export declare function waitForLiFiCompletion(client: HyperMid, params: {
+    txHash: string;
+    fromChain?: string | number;
+    toChain?: string | number;
+    bridge?: string;
+}, options?: ExecutionConfig & {
+    onPoll?: (status: StatusResponse) => void;
+}): Promise<StatusResponse>;
+/**
+ * Execute a full swap lifecycle: quote → execute → sign → poll → complete.
+ *
+ * This is the highest-level SDK method, managing the entire flow. You provide
+ * hooks for wallet signing (LI.FI) or token transfer (Near Intents), and the
+ * SDK handles everything else.
+ *
+ * @example Full automated LI.FI swap
+ * ```ts
+ * import { HyperMid, executeSwap } from "@hypermid/sdk";
+ * import { sendTransaction } from "your-wallet-lib";
+ *
+ * const hm = new HyperMid({ apiKey: "..." });
+ *
+ * const result = await executeSwap(hm, {
+ *   fromChain: 1,
+ *   fromToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ *   fromAmount: "100000000",
+ *   toChain: 42161,
+ *   toToken: "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
+ *   fromAddress: "0x...",
+ *   toAddress: "0x...",
+ * }, {
+ *   onTransactionRequest: async (response) => {
+ *     const txHash = await sendTransaction(response.transactionRequest);
+ *     return txHash;
+ *   },
+ *   onStatusChange: (update) => {
+ *     console.log(`Status: ${update.status}`);
+ *   },
+ * });
+ * ```
+ *
+ * @example Full automated Near Intents swap (wallet connected)
+ * ```ts
+ * const result = await executeSwap(hm, {
+ *   fromChain: ChainId.TRON,
+ *   fromToken: "...",
+ *   fromAmount: "10000000",
+ *   toChain: ChainId.TON,
+ *   toToken: "...",
+ *   fromAddress: "T...",
+ *   toAddress: "EQ...",
+ * }, {
+ *   onDepositRequired: async (response) => {
+ *     const txHash = await tronWeb.transfer(response.depositAddress, amount);
+ *     return txHash;
+ *   },
+ *   onStatusChange: (update) => {
+ *     console.log(`Status: ${update.status}`);
+ *   },
+ * });
+ * ```
+ *
+ * @example Manual deposit flow (no wallet signing — just poll)
+ * ```ts
+ * const result = await executeSwap(hm, {
+ *   fromChain: ChainId.NEAR,
+ *   ...params,
+ *   depositMode: "manual",
+ * }, {
+ *   onStatusChange: (update) => {
+ *     if (update.status === "WAITING_DEPOSIT" && update.executeResponse) {
+ *       // Show QR code with depositAddress to user
+ *       showQRCode(update.executeResponse.depositAddress);
+ *     }
+ *   },
+ * });
+ * // Polling runs until terminal status
+ * ```
+ */
+export declare function executeSwap(client: HyperMid, params: ExecuteParams, hooks?: ExecutionHooks, config?: ExecutionConfig): Promise<ExecutionUpdate>;
+/**
+ * Get a quote and display it before executing. Returns quote data so the
+ * partner can show pricing to the user before proceeding.
+ *
+ * @example
+ * ```ts
+ * const { quote, execute } = await quoteAndPrepare(hm, {
+ *   fromChain: 1, fromToken: "0x...", fromAmount: "100000000",
+ *   toChain: 42161, toToken: "0x...", fromAddress: "0x...", toAddress: "0x...",
+ * });
+ *
+ * // Show quote to user
+ * console.log("You'll receive:", quote.quote.estimate?.toAmount);
+ *
+ * // User confirms → execute
+ * const result = await execute({
+ *   onTransactionRequest: async (resp) => {
+ *     return await wallet.sendTransaction(resp.transactionRequest);
+ *   },
+ * });
+ * ```
+ */
+export declare function quoteAndPrepare(client: HyperMid, params: ExecuteParams): Promise<{
+    quote: QuoteResponse;
+    execute: (hooks?: ExecutionHooks, config?: ExecutionConfig) => Promise<ExecutionUpdate>;
+}>;
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

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

package/dist/execution.js

@@ -0,0 +1,348 @@
+/**
+ * Execution lifecycle management — high-level helpers that manage the
+ * full swap flow: quote → execute → poll status until completion.
+ *
+ * Similar to LI.FI SDK's execution tracking and Near Intents SDK's
+ * status polling, but unified across both providers.
+ */
+import { isLiFiRoute, isNearIntentsRoute, isNIStatusTerminal, isLiFiStatusTerminal } from "./helpers.js";
+// ─── Polling helpers ─────────────────────────────────────────────────────
+/**
+ * Poll Near Intents deposit/swap status until a terminal state is reached.
+ *
+ * @example
+ * ```ts
+ * const finalStatus = await waitForDepositCompletion(hm, {
+ *   depositAddress: "0x...",
+ * }, {
+ *   onPoll: (status) => console.log("Status:", status.status),
+ * });
+ * ```
+ */
+export async function waitForDepositCompletion(client, params, options) {
+    const interval = options?.pollIntervalMs ?? 5_000;
+    const maxWait = options?.maxWaitMs ?? 600_000;
+    const maxPolls = options?.maxPolls ?? Infinity;
+    const startTime = Date.now();
+    let polls = 0;
+    while (true) {
+        const status = await client.getDepositStatus(params);
+        polls++;
+        options?.onPoll?.(status);
+        if (isNIStatusTerminal(status.status)) {
+            return status;
+        }
+        if (Date.now() - startTime >= maxWait) {
+            throw new Error(`Deposit status polling timed out after ${maxWait}ms (last status: ${status.status})`);
+        }
+        if (polls >= maxPolls) {
+            throw new Error(`Deposit status polling exceeded ${maxPolls} attempts (last status: ${status.status})`);
+        }
+        await sleep(interval);
+    }
+}
+/**
+ * Poll LI.FI swap status until a terminal state is reached.
+ *
+ * @example
+ * ```ts
+ * const finalStatus = await waitForLiFiCompletion(hm, {
+ *   txHash: "0x...",
+ *   fromChain: 1,
+ *   toChain: 42161,
+ * });
+ * ```
+ */
+export async function waitForLiFiCompletion(client, params, options) {
+    const interval = options?.pollIntervalMs ?? 5_000;
+    const maxWait = options?.maxWaitMs ?? 600_000;
+    const maxPolls = options?.maxPolls ?? Infinity;
+    const startTime = Date.now();
+    let polls = 0;
+    while (true) {
+        const status = await client.getStatus({
+            txHash: params.txHash,
+            fromChain: params.fromChain,
+            toChain: params.toChain,
+            bridge: params.bridge,
+        });
+        polls++;
+        options?.onPoll?.(status);
+        if (status.status && isLiFiStatusTerminal(status.status)) {
+            return status;
+        }
+        if (Date.now() - startTime >= maxWait) {
+            throw new Error(`LI.FI status polling timed out after ${maxWait}ms (last status: ${status.status})`);
+        }
+        if (polls >= maxPolls) {
+            throw new Error(`LI.FI status polling exceeded ${maxPolls} attempts (last status: ${status.status})`);
+        }
+        await sleep(interval);
+    }
+}
+// ─── Full execution lifecycle ────────────────────────────────────────────
+/**
+ * Execute a full swap lifecycle: quote → execute → sign → poll → complete.
+ *
+ * This is the highest-level SDK method, managing the entire flow. You provide
+ * hooks for wallet signing (LI.FI) or token transfer (Near Intents), and the
+ * SDK handles everything else.
+ *
+ * @example Full automated LI.FI swap
+ * ```ts
+ * import { HyperMid, executeSwap } from "@hypermid/sdk";
+ * import { sendTransaction } from "your-wallet-lib";
+ *
+ * const hm = new HyperMid({ apiKey: "..." });
+ *
+ * const result = await executeSwap(hm, {
+ *   fromChain: 1,
+ *   fromToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+ *   fromAmount: "100000000",
+ *   toChain: 42161,
+ *   toToken: "0xFF970A61A04b1cA14834A43f5dE4533eBDDB5CC8",
+ *   fromAddress: "0x...",
+ *   toAddress: "0x...",
+ * }, {
+ *   onTransactionRequest: async (response) => {
+ *     const txHash = await sendTransaction(response.transactionRequest);
+ *     return txHash;
+ *   },
+ *   onStatusChange: (update) => {
+ *     console.log(`Status: ${update.status}`);
+ *   },
+ * });
+ * ```
+ *
+ * @example Full automated Near Intents swap (wallet connected)
+ * ```ts
+ * const result = await executeSwap(hm, {
+ *   fromChain: ChainId.TRON,
+ *   fromToken: "...",
+ *   fromAmount: "10000000",
+ *   toChain: ChainId.TON,
+ *   toToken: "...",
+ *   fromAddress: "T...",
+ *   toAddress: "EQ...",
+ * }, {
+ *   onDepositRequired: async (response) => {
+ *     const txHash = await tronWeb.transfer(response.depositAddress, amount);
+ *     return txHash;
+ *   },
+ *   onStatusChange: (update) => {
+ *     console.log(`Status: ${update.status}`);
+ *   },
+ * });
+ * ```
+ *
+ * @example Manual deposit flow (no wallet signing — just poll)
+ * ```ts
+ * const result = await executeSwap(hm, {
+ *   fromChain: ChainId.NEAR,
+ *   ...params,
+ *   depositMode: "manual",
+ * }, {
+ *   onStatusChange: (update) => {
+ *     if (update.status === "WAITING_DEPOSIT" && update.executeResponse) {
+ *       // Show QR code with depositAddress to user
+ *       showQRCode(update.executeResponse.depositAddress);
+ *     }
+ *   },
+ * });
+ * // Polling runs until terminal status
+ * ```
+ */
+export async function executeSwap(client, params, hooks, config) {
+    const emit = (update) => {
+        hooks?.onStatusChange?.(update);
+        return update;
+    };
+    // Step 1: Execute
+    emit({ status: "EXECUTING", provider: "lifi" }); // provider TBD until response
+    const executeResponse = await client.execute(params);
+    const provider = executeResponse.provider;
+    hooks?.onExecute?.(executeResponse);
+    // Step 2: Provider-specific handling
+    if (isLiFiRoute(executeResponse)) {
+        // LI.FI: need wallet to sign transactionRequest
+        if (!hooks?.onTransactionRequest) {
+            // No signing hook — return the transactionRequest for manual handling
+            return emit({
+                status: "EXECUTING",
+                provider: "lifi",
+                executeResponse,
+            });
+        }
+        const txHash = await hooks.onTransactionRequest(executeResponse);
+        emit({
+            status: "PROCESSING",
+            provider: "lifi",
+            executeResponse,
+        });
+        // Poll LI.FI status
+        const finalStatus = await waitForLiFiCompletion(client, {
+            txHash,
+            fromChain: params.fromChain,
+            toChain: params.toChain,
+        }, {
+            ...config,
+            onPoll: (status) => {
+                hooks?.onPoll?.(status);
+                emit({
+                    status: "PROCESSING",
+                    provider: "lifi",
+                    executeResponse,
+                    lifiStatus: status,
+                });
+            },
+        });
+        const finalLiFiStatus = finalStatus.status === "DONE" ? "SUCCESS" : "FAILED";
+        return emit({
+            status: finalLiFiStatus,
+            provider: "lifi",
+            executeResponse,
+            lifiStatus: finalStatus,
+        });
+    }
+    // Near Intents route
+    if (isNearIntentsRoute(executeResponse)) {
+        const isManual = executeResponse.depositMode === "manual";
+        if (isManual) {
+            // Manual deposit: show address to user, then poll
+            emit({
+                status: "WAITING_DEPOSIT",
+                provider: "near-intents",
+                executeResponse,
+            });
+            // Poll — 1Click auto-detects manual deposits
+            const finalStatus = await waitForDepositCompletion(client, {
+                depositAddress: executeResponse.depositAddress,
+                depositMemo: executeResponse.depositMemo,
+            }, {
+                ...config,
+                onPoll: (status) => {
+                    hooks?.onPoll?.(status);
+                    emit({
+                        status: isNIStatusTerminal(status.status)
+                            ? mapNIStatus(status.status)
+                            : "PROCESSING",
+                        provider: "near-intents",
+                        executeResponse,
+                        depositStatus: status,
+                    });
+                },
+            });
+            return emit({
+                status: mapNIStatus(finalStatus.status),
+                provider: "near-intents",
+                executeResponse,
+                depositStatus: finalStatus,
+            });
+        }
+        // Wallet deposit
+        if (!hooks?.onDepositRequired) {
+            // No deposit hook — return deposit address for manual handling
+            return emit({
+                status: "WAITING_DEPOSIT",
+                provider: "near-intents",
+                executeResponse,
+            });
+        }
+        const txHash = await hooks.onDepositRequired(executeResponse);
+        emit({
+            status: "DEPOSIT_SUBMITTED",
+            provider: "near-intents",
+            executeResponse,
+        });
+        // Submit deposit tx hash for faster detection
+        await client.submitDeposit({
+            txHash,
+            depositAddress: executeResponse.depositAddress,
+        });
+        // Poll deposit status
+        const finalStatus = await waitForDepositCompletion(client, {
+            depositAddress: executeResponse.depositAddress,
+            depositMemo: executeResponse.depositMemo,
+        }, {
+            ...config,
+            onPoll: (status) => {
+                hooks?.onPoll?.(status);
+                emit({
+                    status: isNIStatusTerminal(status.status)
+                        ? mapNIStatus(status.status)
+                        : "PROCESSING",
+                    provider: "near-intents",
+                    executeResponse,
+                    depositStatus: status,
+                });
+            },
+        });
+        return emit({
+            status: mapNIStatus(finalStatus.status),
+            provider: "near-intents",
+            executeResponse,
+            depositStatus: finalStatus,
+        });
+    }
+    // Should never reach here
+    return emit({
+        status: "FAILED",
+        provider: executeResponse.provider,
+        executeResponse: executeResponse,
+        error: "Unknown provider in execute response",
+    });
+}
+// ─── Convenience: Quote + Execute in one call ────────────────────────────
+/**
+ * Get a quote and display it before executing. Returns quote data so the
+ * partner can show pricing to the user before proceeding.
+ *
+ * @example
+ * ```ts
+ * const { quote, execute } = await quoteAndPrepare(hm, {
+ *   fromChain: 1, fromToken: "0x...", fromAmount: "100000000",
+ *   toChain: 42161, toToken: "0x...", fromAddress: "0x...", toAddress: "0x...",
+ * });
+ *
+ * // Show quote to user
+ * console.log("You'll receive:", quote.quote.estimate?.toAmount);
+ *
+ * // User confirms → execute
+ * const result = await execute({
+ *   onTransactionRequest: async (resp) => {
+ *     return await wallet.sendTransaction(resp.transactionRequest);
+ *   },
+ * });
+ * ```
+ */
+export async function quoteAndPrepare(client, params) {
+    const quoteParams = {
+        fromChain: params.fromChain,
+        fromToken: params.fromToken,
+        fromAmount: params.fromAmount,
+        toChain: params.toChain,
+        toToken: params.toToken,
+        fromAddress: params.fromAddress,
+        toAddress: params.toAddress,
+        slippage: params.slippage,
+        order: params.order,
+    };
+    const quote = await client.getQuote(quoteParams);
+    return {
+        quote,
+        execute: (hooks, config) => executeSwap(client, params, hooks, config),
+    };
+}
+// ─── Internal helpers ────────────────────────────────────────────────────
+function mapNIStatus(status) {
+    switch (status) {
+        case "SUCCESS": return "SUCCESS";
+        case "REFUNDED": return "REFUNDED";
+        case "FAILED": return "FAILED";
+        default: return "PROCESSING";
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=execution.js.map

package/dist/execution.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type guards and utility helpers for working with HyperMid API responses.
+ */
+import type { ExecuteResponse, LiFiExecuteResponse, NIExecuteResponse, SuperSwapExecuteResponse, DepositStatusResponse } from "./types.js";
+/**
+ * Check if an execute response is a LI.FI route (has transactionRequest).
+ *
+ * @example
+ * ```ts
+ * const result = await hm.execute(params);
+ * if (isLiFiRoute(result)) {
+ *   const tx = result.transactionRequest;
+ *   // Sign and send with your wallet provider
+ * }
+ * ```
+ */
+export declare function isLiFiRoute(response: ExecuteResponse): response is LiFiExecuteResponse;
+/**
+ * Check if an execute response is a SuperSwap route (PulseChain via Hyperlane).
+ *
+ * @example
+ * ```ts
+ * const result = await hm.execute(params);
+ * if (isSuperSwapRoute(result)) {
+ *   const tx = result.transactionRequest;
+ *   // Sign and send, then call registerInboundReceiver()
+ * }
+ * ```
+ */
+export declare function isSuperSwapRoute(response: ExecuteResponse): response is SuperSwapExecuteResponse;
+/**
+ * Check if an execute response is a Near Intents route (has depositAddress).
+ *
+ * @example
+ * ```ts
+ * const result = await hm.execute(params);
+ * if (isNearIntentsRoute(result)) {
+ *   console.log("Send tokens to:", result.depositAddress);
+ * }
+ * ```
+ */
+export declare function isNearIntentsRoute(response: ExecuteResponse): response is NIExecuteResponse;
+/**
+ * Check if a Near Intents deposit requires manual user action (QR code / copy address).
+ */
+export declare function isManualDeposit(response: ExecuteResponse): boolean;
+/**
+ * Check if a Near Intents deposit can be done programmatically via wallet.
+ */
+export declare function isWalletDeposit(response: ExecuteResponse): boolean;
+/**
+ * Check if a Near Intents deposit status is terminal (no more polling needed).
+ */
+export declare function isNIStatusTerminal(status: string): boolean;
+/**
+ * Check if a LI.FI status is terminal.
+ */
+export declare function isLiFiStatusTerminal(status: string): boolean;
+/**
+ * Check if a Near Intents swap completed successfully.
+ */
+export declare function isDepositSuccess(response: DepositStatusResponse): boolean;
+/**
+ * Check if a Near Intents swap was refunded.
+ */
+export declare function isDepositRefunded(response: DepositStatusResponse): boolean;
+/**
+ * Check if a Near Intents swap failed.
+ */
+export declare function isDepositFailed(response: DepositStatusResponse): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,mBAAmB,CAEtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,wBAAwB,CAEhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,iBAAiB,CAE3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAKlE;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAExE"}