@lendasat/lendaswap-sdk-pure 0.2.24 → 0.2.26

package/dist/generated/api.d.ts

@@ -94,6 +94,34 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/swap/arkade-lightning/{id}/collab-refund": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Collaboratively refund an Arkade-to-Lightning VHTLC.
+         * @description The client builds and partially signs the refund transaction, then POSTs it
+         *     here. The server obtains the receiver cosignature and returns the result.
+         *     Only allowed when the swap is in `ServerWontFund` or `ClientInvalidFunded`
+         *     state.
+         *
+         *     After receiving the response the client must:
+         *     1. Submit the cosigned PSBTs to the Arkade server for the server signature
+         *     2. Merge all checkpoint signatures and sign as sender
+         *     3. Finalize the transaction with the Arkade server
+         */
+        post: operations["collab_refund_arkade_to_lightning"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/swap/{id}/collab-refund-evm": {
         parameters: {
             query?: never;
@@ -285,6 +313,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Probe every external dependency and return their aggregated health.
+         * @description Returns 200 when every service is healthy, 503 otherwise — the body
+         *     carries the per-service breakdown either way so callers can distinguish
+         *     which dependency is down.
+         */
+        get: operations["get_status"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/support-agents": {
         parameters: {
             query?: never;
@@ -773,6 +823,29 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/swap/{id}/swap-and-lock-calldata-userop": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Returns data for funding an EVM-to-BTC swap via a user's 4337 smart
+         *     account. The client composes a UserOperation that executes receiveMessage
+         *     (for CCTP-inbound) + USDC.approve(Permit2, max) + executeAndCreateWithPermit2
+         *     atomically — `destinationCaller` on the source-chain burn is the smart
+         *     account address, so CCTPv2's receiveMessage gating is pinned to it.
+         */
+        get: operations["get_coordinator_funding_calldata_userop"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/tokens": {
         parameters: {
             query?: never;
@@ -815,6 +888,23 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /**
+         * @description ERC-4337 / Kernel specific addresses the client uses to derive its
+         *     smart-account sender + compose `initCode`.
+         */
+        AaConfig: {
+            /** @description Kernel (ZeroDev) factory address on this chain. */
+            account_factory: string;
+            /** @description Kernel implementation the factory deploys. */
+            account_impl: string;
+            /** @description Canonical EntryPoint v0.7 deployment. */
+            entry_point: string;
+            /**
+             * @description Salt used when deriving the smart-account address. Pinned to "0"
+             *     so each user has exactly one smart account per signing key.
+             */
+            salt: string;
+        };
         /**
          * @description Chain-agnostic request for Arkade-to-EVM swaps.
          *
@@ -836,6 +926,11 @@ export interface components {
              *     USDC).
              */
             amount_out?: number | null;
+            /**
+             * @description ATA-existence flag for non-EVM CCTP destinations (Solana).
+             *     See `BitcoinToEvmSwapRequest::bridge_recipient_setup`.
+             */
+            bridge_recipient_setup?: boolean;
             /**
              * @description Optional: CCTP bridge destination chain (e.g., "Ethereum", "Arbitrum"). When set,
              *     USDC will be bridged to this chain after the DEX swap.
@@ -919,6 +1014,20 @@ export interface components {
             /** @description WBTC token contract address on the target EVM chain (the token locked in the HTLC). */
             wbtc_address: string;
         };
+        /** @description Request for a collaborative VHTLC refund. */
+        ArkadeToLightningCollabRefundRequest: {
+            /** @description Base64-encoded ark transaction PSBT, partially signed by the sender (client). */
+            ark_tx: string;
+            /** @description Base64-encoded checkpoint transaction PSBT (unsigned). */
+            checkpoint: string;
+        };
+        /** @description Response with cosigned PSBTs for a collaborative refund. */
+        ArkadeToLightningCollabRefundResponse: {
+            /** @description Base64-encoded ark transaction PSBT with receiver cosignature added. */
+            ark_tx: string;
+            /** @description Base64-encoded checkpoint PSBT with receiver cosignature added. */
+            checkpoint: string;
+        };
         /**
          * @description Request for creating an Arkade-to-Lightning swap.
          *
@@ -1058,6 +1167,17 @@ export interface components {
              *     USDC).
              */
             amount_out?: number | null;
+            /**
+             * @description ATA-existence flag for non-EVM CCTP destinations (Solana).
+             *     `true` = recipient has no USDC ATA yet (Circle's forwarder
+             *     creates one, paid out of the burn). `false` (default) = recipient
+             *     already holds USDC, or destination is EVM. Drives the bridge-fee
+             *     variant used when inflating the DEX target and must match the
+             *     value later passed to `redeem-and-swap-calldata` so the burn
+             *     doesn't underflow. Solana callers are responsible for probing
+             *     the destination chain and setting this correctly.
+             */
+            bridge_recipient_setup?: boolean;
             /**
              * @description Optional: CCTP bridge destination chain (e.g., "Ethereum", "Arbitrum"). When set,
              *     USDC will be bridged to this chain after the DEX swap.
@@ -1259,7 +1379,7 @@ export interface components {
              */
             vhtlc_refund_locktime: number;
         };
-        /** @description A single call in the coordinator's Call[] array. */
+        /** @description A single call in the coordinator's Call[] array, serialized as JSON. */
         CallJson: {
             call_data: string;
             target: string;
@@ -1310,6 +1430,22 @@ export interface components {
          *     ```
          */
         ClaimGaslessRequest: {
+            /**
+             * @description Optional non-EVM bridge recipient (e.g. a Solana base58 SPL pubkey).
+             *     Used as CCTP `mintRecipient` when `bridge_target_chain` is non-EVM;
+             *     must match the value passed to `redeem-and-swap-calldata` so the
+             *     rebuilt `calls_hash` matches the EIP-712 signature.
+             *
+             *     For Solana: this is the recipient's USDC ATA, not their wallet.
+             */
+            bridge_recipient?: string | null;
+            /**
+             * @description Optional Solana wallet pubkey, supplied alongside `bridge_recipient`
+             *     when the recipient's USDC ATA does not yet exist. Triggers the
+             *     extended 65-byte forwarding hookData. Must mirror what was passed to
+             *     `redeem-and-swap-calldata` so the rebuilt `calls_hash` matches.
+             */
+            bridge_recipient_wallet?: string | null;
             /** @description EVM address where tokens should be sent */
             destination: string;
             dex_calldata?: null | components["schemas"]["DexCalldata"];
@@ -1551,6 +1687,15 @@ export interface components {
              * @description Desired BTC output in sats (mutually exclusive with `amount_in`).
              */
             amount_out?: number | null;
+            /**
+             * @description Optional: CCTP bridge source chain (e.g., "Ethereum", "Optimism"). When set,
+             *     the user's source USDC originates on this chain and hops through CCTPv2 to
+             *     Arbitrum before the HTLC is created. The backend pads `deposit_amount` by
+             *     the fast-transfer fee at UserOp-calldata time.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Optional: USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             /**
              * Format: int64
              * @description Numeric EVM chain ID: 1 (Ethereum), 137 (Polygon), 42161 (Arbitrum).
@@ -1576,6 +1721,16 @@ export interface components {
         /** @description EVM → Arkade (generic) swap response */
         EvmToArkadeSwapResponse: {
             arkade_server_pk: string;
+            /**
+             * @description CCTP bridge source chain. Set when the source USDC originated on
+             *     another CCTP chain and hopped to Arbitrum via CCTPv2 before the
+             *     HTLC was created. `source_token` still reports the post-hop
+             *     Arbitrum USDC; this field tells the SDK what chain the user is
+             *     expected to burn from.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Native USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             btc_claim_txid?: string | null;
             btc_fund_txid?: string | null;
             btc_vhtlc_address: string;
@@ -1634,6 +1789,15 @@ export interface components {
              * @description Desired BTC output in sats (mutually exclusive with `amount_in`).
              */
             amount_out?: number | null;
+            /**
+             * @description Optional: CCTP bridge source chain (e.g., "Ethereum", "Optimism"). When set,
+             *     the user's source USDC originates on this chain and hops through CCTPv2 to
+             *     Arbitrum before the HTLC is created. The backend pads `deposit_amount` by
+             *     the fast-transfer fee at UserOp-calldata time.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Optional: USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             /** @description User's BTC public key for claiming BTC from the on-chain Taproot HTLC. */
             claim_pk: string;
             /**
@@ -1658,6 +1822,16 @@ export interface components {
         };
         /** @description EVM → Bitcoin (on-chain) swap response */
         EvmToBitcoinSwapResponse: {
+            /**
+             * @description CCTP bridge source chain. Set when the source USDC originated on
+             *     another CCTP chain and hopped to Arbitrum via CCTPv2 before the
+             *     HTLC was created. `source_token` still reports the post-hop
+             *     Arbitrum USDC; this field tells the SDK what chain the user is
+             *     expected to burn from.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Native USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             btc_claim_txid?: string | null;
             btc_fund_txid?: string | null;
             /** Format: int64 */
@@ -1738,6 +1912,15 @@ export interface components {
              *     `lightning_invoice` is provided (amount is read from the invoice).
              */
             amount_sats?: number | null;
+            /**
+             * @description Optional: CCTP bridge source chain (e.g., "Ethereum", "Optimism"). When set,
+             *     the user's source USDC originates on this chain and hops through CCTPv2 to
+             *     Arbitrum before the HTLC is created. The backend pads `deposit_amount` by
+             *     the fast-transfer fee at UserOp-calldata time.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Optional: USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             /**
              * Format: int64
              * @description Numeric EVM chain ID: 1 (Ethereum), 137 (Polygon), 42161 (Arbitrum).
@@ -1773,6 +1956,16 @@ export interface components {
         /** @description EVM → Lightning swap response */
         EvmToLightningSwapResponse: {
             arkade_server_pk: string;
+            /**
+             * @description CCTP bridge source chain. Set when the source USDC originated on
+             *     another CCTP chain and hopped to Arbitrum via CCTPv2 before the
+             *     HTLC was created. `source_token` still reports the post-hop
+             *     Arbitrum USDC; this field tells the SDK what chain the user is
+             *     expected to burn from.
+             */
+            bridge_source_chain?: string | null;
+            /** @description Native USDC address on the bridge source chain. */
+            bridge_source_token_address?: string | null;
             chain: string;
             client_evm_address: string;
             /** @description User's Lightning invoice to receive payment */
@@ -1983,6 +2176,11 @@ export interface components {
              *     USDC).
              */
             amount_out?: number | null;
+            /**
+             * @description ATA-existence flag for non-EVM CCTP destinations (Solana).
+             *     See `BitcoinToEvmSwapRequest::bridge_recipient_setup`.
+             */
+            bridge_recipient_setup?: boolean;
             /**
              * @description Optional: CCTP bridge destination chain (e.g., "Ethereum", "Arbitrum"). When set,
              *     USDC will be bridged to this chain after the DEX swap.
@@ -2198,6 +2396,36 @@ export interface components {
          * @enum {string}
          */
         RefundMode: "direct" | "swap-back";
+        /**
+         * @description Per-service health datapoint.
+         *
+         *     Failures intentionally do not include the underlying error: transport
+         *     errors from RPC clients can echo back full URLs (with embedded API keys)
+         *     and other internal topology. Detailed errors are logged server-side; the
+         *     public response only carries a sanitized `"unavailable"` marker.
+         */
+        ServiceStatus: {
+            /**
+             * Format: int64
+             * @description Tip / block height for chain-backed services (Bitcoin and EVMs).
+             */
+            block_height?: number | null;
+            /**
+             * Format: int64
+             * @description Tip block timestamp (Unix seconds) for chain-backed services.
+             */
+            block_time?: number | null;
+            error?: string | null;
+            healthy: boolean;
+        };
+        ServicesStatus: {
+            arbitrum: components["schemas"]["ServiceStatus"];
+            arkade: components["schemas"]["ServiceStatus"];
+            bitcoin: components["schemas"]["ServiceStatus"];
+            ethereum: components["schemas"]["ServiceStatus"];
+            lightning: components["schemas"]["ServiceStatus"];
+            polygon: components["schemas"]["ServiceStatus"];
+        };
         SettleDelegateRequest: {
             /** @description Hex-encoded compressed cosigner public key (must match our static key). */
             cosigner_pk: string;
@@ -2219,6 +2447,12 @@ export interface components {
             /** @description Commitment transaction ID from the batch settlement. */
             commitment_txid: string;
         };
+        /** @description Aggregated health of every external dependency. */
+        StatusResponse: {
+            /** @description True if every probed service is healthy. */
+            healthy: boolean;
+            services: components["schemas"]["ServicesStatus"];
+        };
         SupportAgentInfo: {
             npub: string;
         };
@@ -2293,7 +2527,7 @@ export interface components {
          *     - `ClientRefundedServerFunded` is an error state that should never occur
          * @enum {string}
          */
-        SwapStatus: "pending" | "clientfundingseen" | "clientfunded" | "clientrefunded" | "serverfunded" | "clientredeeming" | "clientredeemed" | "serverredeemed" | "clientfundedserverrefunded" | "clientrefundedserverfunded" | "clientrefundedserverrefunded" | "expired" | "clientinvalidfunded" | "clientfundedtoolate" | "clientredeemedandclientrefunded";
+        SwapStatus: "pending" | "clientfundingseen" | "clientfunded" | "clientrefunded" | "serverfunded" | "clientredeeming" | "clientredeemed" | "serverredeemed" | "clientfundedserverrefunded" | "clientrefundedserverfunded" | "clientrefundedserverrefunded" | "expired" | "clientinvalidfunded" | "clientfundedtoolate" | "serverwontfund" | "clientredeemedandclientrefunded";
         /** @description Token identifier. Known values: btc, 0x123456 */
         TokenId: "btc" | string;
         TokenInfo: {
@@ -2308,6 +2542,27 @@ export interface components {
             btc_tokens: components["schemas"]["TokenInfo"][];
             evm_tokens: components["schemas"]["TokenInfo"][];
         };
+        /**
+         * @description Response: same HTLC + DEX payload the Permit2 endpoint returns, plus
+         *     an `aa` object with the addresses a 4337 client needs.
+         */
+        UseropFundingCalldataResponse: {
+            /** @description 4337 / Kernel addresses. */
+            aa: components["schemas"]["AaConfig"];
+            calls: components["schemas"]["CallJson"][];
+            calls_hash: string;
+            claim_address: string;
+            coordinator_address: string;
+            lock_token_address: string;
+            permit2_address: string;
+            preimage_hash: string;
+            relay_fee?: string | null;
+            /** Format: int64 */
+            source_amount: number;
+            source_token_address: string;
+            /** Format: int64 */
+            timelock: number;
+        };
         Version: {
             commit_hash: string;
             tag: string;
@@ -2591,6 +2846,69 @@ export interface operations {
             };
         };
     };
+    collab_refund_arkade_to_lightning: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Swap ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ArkadeToLightningCollabRefundRequest"];
+            };
+        };
+        responses: {
+            /** @description Cosigned PSBTs */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ArkadeToLightningCollabRefundResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Refund not allowed in current swap state */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Swap not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     collab_refund_evm: {
         parameters: {
             query?: never;
@@ -2945,6 +3263,24 @@ export interface operations {
                  *     When set, the CCTP forwarding fee is deducted from the target amount.
                  */
                 bridge_target_chain?: string | null;
+                /**
+                 * @description Optional: CCTP bridge source chain (e.g., "Optimism", "Base"). Set when
+                 *     the user's source USDC originates on another CCTP chain and hops to
+                 *     Arbitrum via CCTPv2 before the HTLC is created. The quote internally
+                 *     runs the DEX calculation on Arbitrum-native USDC and accounts for the
+                 *     fast-transfer fee deducted on the burn.
+                 */
+                bridge_source_chain?: string | null;
+                /**
+                 * @description `true` when the recipient's USDC token account on the destination
+                 *     chain does NOT yet exist and Circle's forwarder needs to create it
+                 *     (only meaningful for non-EVM destinations like Solana — adds
+                 *     ~$0.05 of ATA rent to `forwardFee`). `false` (default) confirms
+                 *     the recipient already holds USDC, and is correct for all EVM
+                 *     destinations. Solana callers are responsible for probing the
+                 *     destination chain and setting this correctly.
+                 */
+                bridge_recipient_setup?: boolean;
                 /** @description Optional referral code for tracking. */
                 ref?: string | null;
             };
@@ -2974,6 +3310,35 @@ export interface operations {
             };
         };
     };
+    get_status: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description All external dependencies are healthy */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatusResponse"];
+                };
+            };
+            /** @description At least one external dependency is unhealthy */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatusResponse"];
+                };
+            };
+        };
+    };
     get_support_agents: {
         parameters: {
             query?: never;
@@ -3777,6 +4142,47 @@ export interface operations {
             };
         };
     };
+    get_coordinator_funding_calldata_userop: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Swap ID */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description UserOp funding data */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UseropFundingCalldataResponse"];
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     get_tokens: {
         parameters: {
             query?: {