@lendasat/lendaswap-sdk-pure 0.2.41 → 0.2.43

package/dist/generated/api.d.ts

@@ -223,6 +223,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/chain-config": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Return per-chain configuration (BTC-pegged token, … more to come). */
+        get: operations["get_chain_config"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/dex-calldata/claim": {
         parameters: {
             query?: never;
@@ -363,6 +380,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/network-fees": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Return per-pair network-fee estimates in sats at current gas / mining
+         *     prices.
+         */
+        get: operations["get_network_fees"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/quote": {
         parameters: {
             query?: never;
@@ -1037,7 +1074,10 @@ export interface components {
             referral_code?: string | null;
             /** @description Refund public key used to generate the Arkade VHTLC. */
             refund_pk: string;
-            /** @description EVM address where tokens are swept after the claim (user's final destination). */
+            /**
+             * @description Recipient where tokens land after the claim (user's final destination).
+             *     An EVM hex address, or a base58 Solana pubkey for a Solana bridge target.
+             */
             target_address: string;
             /** @description ERC-20 contract address of the desired token on the target chain. */
             token_address: string;
@@ -1296,7 +1336,10 @@ export interface components {
             referral_code?: string | null;
             /** @description Refund public key used to generate the Arkade VHTLC. */
             refund_pk: string;
-            /** @description EVM address where tokens are swept after the claim (user's final destination). */
+            /**
+             * @description Recipient where tokens land after the claim (user's final destination).
+             *     An EVM hex address, or a base58 Solana pubkey for a Solana bridge target.
+             */
             target_address: string;
             /** @description ERC-20 contract address of the desired token on the target chain. */
             token_address: string;
@@ -1483,6 +1526,39 @@ export interface components {
          * @enum {string}
          */
         Chain: "Arkade" | "Lightning" | "Bitcoin" | "137" | "1" | "42161";
+        /**
+         * @description Per-chain configuration. EVM chains only — Bitcoin / Lightning /
+         *     Arkade don't have a meaningful chain-config shape.
+         */
+        ChainConfigEntry: {
+            /**
+             * @description How many `btc_pegged_token` units equal 1 BTC, as a decimal
+             *     string. Multiply BTC sats by this — then scale by the token's
+             *     decimals — to get pegged-token base units for a direct BTC↔pegged
+             *     conversion (the leg with no DEX hop); divide for the inverse.
+             *
+             *     Currently always `"1"`: every supported peg (tBTC, WBTC) is treated
+             *     1:1 against BTC. The field is here so a chain whose peg genuinely
+             *     deviates can report its real rate without a client change. If that
+             *     ever becomes a live market rate, treat it as a quote input — refresh
+             *     on the quote cadence, not as session-permanent config.
+             */
+            btc_peg_rate: string;
+            /**
+             * @description The chain's BTC-pegged token (tBTC v2 on Arbitrum / Ethereum,
+             *     WBTC on Polygon). Used as the DEX pivot when composing a quote
+             *     for any BTC↔this-chain pair.
+             */
+            btc_pegged_token: components["schemas"]["TokenRef"];
+            /**
+             * @description Chain identifier — EVM chain id as a string (`"1"`, `"137"`,
+             *     `"42161"`), matching the encoding used elsewhere in the API.
+             */
+            chain: components["schemas"]["Chain"];
+        };
+        ChainConfigResponse: {
+            chains: components["schemas"]["ChainConfigEntry"][];
+        };
         /**
          * @description Request body for `POST /swap/{id}/claim-gasless`.
          *
@@ -1698,30 +1774,6 @@ export interface components {
             /** @description List of VTXO outpoints to refresh */
             vtxos: string[];
         };
-        /**
-         * @description Which side the caller is pinning on the requested swap.
-         *
-         *     Stringified `u128` rather than typed integer — matches the rest of the
-         *     API (`net_source_amount`, `min_amount_out`, …) and dodges the JS
-         *     `Number` precision cliff at 2^53 for 18-decimal tokens.
-         */
-        DexAmount: {
-            /** @enum {string} */
-            kind: "exact_in";
-            /**
-             * @description Spend exactly this much `from_token`; receive at least the
-             *     response's `estimated_amount_out` (post-slippage) of `to_token`.
-             */
-            value: string;
-        } | {
-            /** @enum {string} */
-            kind: "exact_out";
-            /**
-             * @description Receive exactly this much `to_token`; spend at most the
-             *     response's `expected_amount_in` (post-slippage) of `from_token`.
-             */
-            value: string;
-        };
         /**
          * @description A single EVM contract call the SDK should embed in its batch user op.
          *
@@ -1760,6 +1812,30 @@ export interface components {
             /** @description Native token value (usually "0") */
             value?: string;
         };
+        /**
+         * @description Which side the caller is pinning on the requested swap.
+         *
+         *     Stringified `u128` rather than typed integer — matches the rest of the
+         *     API (`net_source_amount`, `min_amount_out`, …) and dodges the JS
+         *     `Number` precision cliff at 2^53 for 18-decimal tokens.
+         */
+        DexCalldataAmount: {
+            /** @enum {string} */
+            kind: "exact_in";
+            /**
+             * @description Spend exactly this much `from_token`; receive at least the
+             *     response's `estimated_amount_out` (post-slippage) of `to_token`.
+             */
+            value: string;
+        } | {
+            /** @enum {string} */
+            kind: "exact_out";
+            /**
+             * @description Receive exactly this much `to_token`; spend at most the
+             *     response's `expected_amount_in` (post-slippage) of `from_token`.
+             */
+            value: string;
+        };
         /**
          * @description Request shared by both `/dex-calldata/claim` and `/dex-calldata/fund`.
          *
@@ -1772,7 +1848,7 @@ export interface components {
              * @description Either the input amount (exact-in) or the desired output amount
              *     (exact-out), both as stringified `u128` smallest-unit values.
              */
-            amount: components["schemas"]["DexAmount"];
+            amount: components["schemas"]["DexCalldataAmount"];
             /**
              * @description Source asset the SDK will spend. Must be a [`Token::Evm`] variant —
              *     EOAs only delegate via EIP-7702 on EVM. `Solana` is rejected with
@@ -1866,6 +1942,35 @@ export interface components {
             /** @enum {string} */
             kind: "evm";
         };
+        /**
+         * @description Which side the caller is pinning on the requested quote.
+         *
+         *     Stringified `u128` rather than typed integer — matches the rest of the
+         *     API (`net_source_amount`, `min_amount_out`, …) and dodges the JS
+         *     `Number` precision cliff at 2^53 for 18-decimal tokens.
+         *
+         *     Mirrors `dex_calldata::DexAmount` on the wire but kept as a separate
+         *     Rust type so the two endpoints can evolve independently.
+         */
+        DexQuoteAmount: {
+            /** @enum {string} */
+            kind: "exact_in";
+            /**
+             * @description Spend exactly this much `from_token`; the response's
+             *     `estimated_amount_out` is the expected (mid-market) receive
+             *     amount that the requested slippage tolerance covers.
+             */
+            value: string;
+        } | {
+            /** @enum {string} */
+            kind: "exact_out";
+            /**
+             * @description Receive exactly this much `to_token`; the response's
+             *     `expected_amount_in` is the expected (mid-market) required input
+             *     at the requested slippage tolerance.
+             */
+            value: string;
+        };
         /**
          * @description A single hop in the route the server picked.
          *
@@ -1906,7 +2011,7 @@ export interface components {
              * @description Either the input amount (exact-in) or the desired output amount
              *     (exact-out), both as stringified `u128` smallest-unit values.
              */
-            amount: components["schemas"]["DexAmount"];
+            amount: components["schemas"]["DexQuoteAmount"];
             /**
              * @description Source asset. Must be a [`Token::Evm`] variant — price discovery
              *     is rooted in an EVM settlement hub; `Solana` is rejected with a
@@ -2598,7 +2703,10 @@ export interface components {
             referral_code?: string | null;
             /** @description Refund public key used to generate the Arkade VHTLC. */
             refund_pk: string;
-            /** @description EVM address where tokens are swept after the claim (user's final destination). */
+            /**
+             * @description Recipient where tokens land after the claim (user's final destination).
+             *     An EVM hex address, or a base58 Solana pubkey for a Solana bridge target.
+             */
             target_address: string;
             /** @description ERC-20 contract address of the desired token on the target chain. */
             token_address: string;
@@ -2675,6 +2783,42 @@ export interface components {
              */
             tip_height: number;
         };
+        /**
+         * @description Sats the server pays on each side of the pair at *current* gas/mining
+         *     prices. Extensible — future breakouts (`htlc_create_sats`,
+         *     `dex_swap_sats`, …) land alongside.
+         */
+        NetworkFee: {
+            /**
+             * Format: int64
+             * @description Sats the server incurs on the source side of the swap.
+             *
+             *     - **Bitcoin**: BTC mining fee for the HTLC claim transaction.
+             *     - **EVM**: gas-to-sats for the HTLC-claim transaction.
+             */
+            source_sats: number;
+            /**
+             * Format: int64
+             * @description Sats the server incurs on the target side of the swap.
+             *
+             *     - **EVM**: gas-to-sats for the HTLC-create transaction.
+             *     - **Bitcoin**: BTC mining fee.
+             */
+            target_sats: number;
+        };
+        /**
+         * @description One entry in the pair grid. Same shape vocabulary as
+         *     [`crate::api::swap_pairs::SwapPairInfo`] so SDK consumers can join on
+         *     `(source, target)`.
+         */
+        NetworkFeePairEntry: {
+            fees: components["schemas"]["NetworkFee"];
+            source: components["schemas"]["Chain"];
+            target: components["schemas"]["Chain"];
+        };
+        NetworkFeesResponse: {
+            pairs: components["schemas"]["NetworkFeePairEntry"][];
+        };
         QuoteResponse: {
             /**
              * Format: int64
@@ -2788,18 +2932,20 @@ export interface components {
             /** @description List of recovered swaps with their derivation indices */
             swaps: components["schemas"]["RecoveredSwap"][];
         };
-        /** @description Response containing fresh DEX calldata and the gasless fee that will be deducted at claim time. */
+        /** @description Response containing fresh DEX calldata for an EVM-targeted gasless claim. */
         RedeemAndSwapResponse: {
             /**
-             * @description keccak256(abi.encode(calls)) — the hash of the full calls array (including fee transfer).
+             * @description keccak256(abi.encode(calls)) — the hash of the full calls array.
              *     Must be included in the client's EIP-712 redeem signature to prevent call substitution.
              */
             calls_hash: string;
             dex_calldata?: null | components["schemas"]["DexCallData"];
             /**
              * Format: int64
-             * @description Gasless fee in WBTC sats, estimated at calldata-fetch time.
-             *     The claim endpoint will deduct this from the HTLC amount via a WBTC transfer.
+             * @description Backwards-compatibility only: always 0. The settlement gas is now folded
+             *     into `network_fee` at quote time, so the claim path no longer deducts a
+             *     separate fee. Kept on the wire for older clients; intended for removal in
+             *     a future version.
              */
             gasless_fee_sats: number;
             /**
@@ -2883,15 +3029,16 @@ export interface components {
         SupportAgentsResponse: {
             agents: components["schemas"]["SupportAgentInfo"][];
         };
-        /** @description A supported swap pair with its limits and base fee. */
+        /** @description A supported swap pair with its limits and total fee rate. */
         SwapPairInfo: {
             /**
              * Format: double
-             * @description Fee percentage as a decimal (e.g. 0.0025 = 0.25%).
+             * @description User-facing fee rate as a decimal fraction (e.g. 0.0025 = 0.25%).
              *
-             *     For a swap of 100,000 sats at 0.25% fee, the fee would be 250 sats.
-             *     Swaps involving Lightning may incur additional Lightning Network routing fees
-             *     on top of this percentage.
+             *     The single rate consumers should display. Includes any
+             *     percentage components the server passes through on top of the
+             *     protocol fee — those vary by pair but are bundled here so the
+             *     SDK doesn't have to compose them.
              */
             fee_percentage: number;
             /**
@@ -3029,6 +3176,16 @@ export interface components {
             btc_tokens: components["schemas"]["TokenInfo"][];
             evm_tokens: components["schemas"]["TokenInfo"][];
         };
+        /**
+         * @description Reference to an ERC-20 token plus the decimals/symbol the SDK needs
+         *     to format amounts. Address is lowercase hex (`0x`-prefixed).
+         */
+        TokenRef: {
+            address: string;
+            /** Format: int32 */
+            decimals: number;
+            symbol: string;
+        };
         /**
          * @description Response: same HTLC + DEX payload the Permit2 endpoint returns, plus
          *     an `aa` object with the addresses a 4337 client needs.
@@ -3628,6 +3785,26 @@ export interface operations {
             };
         };
     };
+    get_chain_config: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Per-chain configuration (BTC pivot, contracts, …) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChainConfigResponse"];
+                };
+            };
+        };
+    };
     post_dex_calldata_claim: {
         parameters: {
             query?: never;
@@ -3880,6 +4057,26 @@ export interface operations {
             };
         };
     };
+    get_network_fees: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Per-pair network-fee estimates in sats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NetworkFeesResponse"];
+                };
+            };
+        };
+    };
     get_quote: {
         parameters: {
             query: {