compass_api_sdk 2.2.109__tar.gz → 2.2.110__tar.gz

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compass_api_sdk
-Version: 2.2.109
+Version: 2.2.110
 Summary: Compass API SDK.
 Author: royalnine
 Requires-Python: >=3.10
@@ -249,6 +249,7 @@ with CompassAPI(
 * [credit_unloop](docs/sdks/credit/README.md#credit_unloop) - Unwind a leveraged loop
 * [credit_rebalance](docs/sdks/credit/README.md#credit_rebalance) - Rebalance the leveraged credit book
 * [credit_transfer](docs/sdks/credit/README.md#credit_transfer) - Transfer tokens to/from Credit Account
+* [credit_swap](docs/sdks/credit/README.md#credit_swap) - Swap tokens
 * [credit_repay](docs/sdks/credit/README.md#credit_repay) - Repay debt and withdraw collateral
 * [credit_bundle](docs/sdks/credit/README.md#credit_bundle) - Execute multiple credit actions
 
@@ -264,7 +265,7 @@ with CompassAPI(
 * [earn_create_account](docs/sdks/earn/README.md#earn_create_account) - Create earn account
 * [earn_transfer](docs/sdks/earn/README.md#earn_transfer) - Transfer tokens to/from account
 * [earn_manage](docs/sdks/earn/README.md#earn_manage) - Manage earn position
-* [earn_swap](docs/sdks/earn/README.md#earn_swap) - Swap tokens within Earn Account
+* [earn_swap](docs/sdks/earn/README.md#earn_swap) - Swap tokens
 * [earn_bundle](docs/sdks/earn/README.md#earn_bundle) - Execute multiple earn actions
 
 ### [ERC4626Vaults](docs/sdks/erc4626vaults/README.md)
@@ -328,22 +329,6 @@ with CompassAPI(
 * [perpetual_trading_ensure_leverage](docs/sdks/perpetualtrading/README.md#perpetual_trading_ensure_leverage) - Ensure 1x cross leverage
 * [perpetual_trading_set_leverage](docs/sdks/perpetualtrading/README.md#perpetual_trading_set_leverage) - Set leverage (defaults to market maximum)
 
-### [RiskYield](docs/sdks/riskyield/README.md)
-
-* [risk_yield_tokens](docs/sdks/riskyield/README.md#risk_yield_tokens) - List tokens
-* [risk_yield_pools](docs/sdks/riskyield/README.md#risk_yield_pools) - List pools
-* [risk_yield_pools_pool_id_](docs/sdks/riskyield/README.md#risk_yield_pools_pool_id_) - Get pool detail
-* [risk_yield_positions](docs/sdks/riskyield/README.md#risk_yield_positions) - List LP positions
-* [risk_yield_risk_scenarios](docs/sdks/riskyield/README.md#risk_yield_risk_scenarios) - Model impermanent loss
-* [risk_yield_create_account](docs/sdks/riskyield/README.md#risk_yield_create_account) - Create account
-* [risk_yield_transfer](docs/sdks/riskyield/README.md#risk_yield_transfer) - Transfer tokens to/from account
-* [risk_yield_swap](docs/sdks/riskyield/README.md#risk_yield_swap) - Swap tokens
-* [risk_yield_mint](docs/sdks/riskyield/README.md#risk_yield_mint) - Open a position
-* [risk_yield_increase](docs/sdks/riskyield/README.md#risk_yield_increase) - Add to a position
-* [risk_yield_decrease](docs/sdks/riskyield/README.md#risk_yield_decrease) - Withdraw from a position
-* [risk_yield_collect](docs/sdks/riskyield/README.md#risk_yield_collect) - Collect fees
-* [risk_yield_rebalance](docs/sdks/riskyield/README.md#risk_yield_rebalance) - Rebalance a position
-
 ### [Sky](docs/sdks/sky/README.md)
 
 * [sky_position](docs/sdks/sky/README.md#sky_position) - Check USDS Position
@@ -523,8 +508,8 @@ with CompassAPI(
 
 
 **Inherit from [`CompassAPIError`](./src/compass_api_sdk/errors/compassapierror.py)**:
-* [`TokenizedAssetsErrorResponse`](./src/compass_api_sdk/errors/tokenizedassetserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 12 of 152 methods.*
-* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 152 methods.*
+* [`TokenizedAssetsErrorResponse`](./src/compass_api_sdk/errors/tokenizedassetserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 12 of 140 methods.*
+* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 140 methods.*
 * [`ResponseValidationError`](./src/compass_api_sdk/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/README-PYPI.md

@@ -231,6 +231,7 @@ with CompassAPI(
 * [credit_unloop](docs/sdks/credit/README.md#credit_unloop) - Unwind a leveraged loop
 * [credit_rebalance](docs/sdks/credit/README.md#credit_rebalance) - Rebalance the leveraged credit book
 * [credit_transfer](docs/sdks/credit/README.md#credit_transfer) - Transfer tokens to/from Credit Account
+* [credit_swap](docs/sdks/credit/README.md#credit_swap) - Swap tokens
 * [credit_repay](docs/sdks/credit/README.md#credit_repay) - Repay debt and withdraw collateral
 * [credit_bundle](docs/sdks/credit/README.md#credit_bundle) - Execute multiple credit actions
 
@@ -246,7 +247,7 @@ with CompassAPI(
 * [earn_create_account](docs/sdks/earn/README.md#earn_create_account) - Create earn account
 * [earn_transfer](docs/sdks/earn/README.md#earn_transfer) - Transfer tokens to/from account
 * [earn_manage](docs/sdks/earn/README.md#earn_manage) - Manage earn position
-* [earn_swap](docs/sdks/earn/README.md#earn_swap) - Swap tokens within Earn Account
+* [earn_swap](docs/sdks/earn/README.md#earn_swap) - Swap tokens
 * [earn_bundle](docs/sdks/earn/README.md#earn_bundle) - Execute multiple earn actions
 
 ### [ERC4626Vaults](docs/sdks/erc4626vaults/README.md)
@@ -310,22 +311,6 @@ with CompassAPI(
 * [perpetual_trading_ensure_leverage](docs/sdks/perpetualtrading/README.md#perpetual_trading_ensure_leverage) - Ensure 1x cross leverage
 * [perpetual_trading_set_leverage](docs/sdks/perpetualtrading/README.md#perpetual_trading_set_leverage) - Set leverage (defaults to market maximum)
 
-### [RiskYield](docs/sdks/riskyield/README.md)
-
-* [risk_yield_tokens](docs/sdks/riskyield/README.md#risk_yield_tokens) - List tokens
-* [risk_yield_pools](docs/sdks/riskyield/README.md#risk_yield_pools) - List pools
-* [risk_yield_pools_pool_id_](docs/sdks/riskyield/README.md#risk_yield_pools_pool_id_) - Get pool detail
-* [risk_yield_positions](docs/sdks/riskyield/README.md#risk_yield_positions) - List LP positions
-* [risk_yield_risk_scenarios](docs/sdks/riskyield/README.md#risk_yield_risk_scenarios) - Model impermanent loss
-* [risk_yield_create_account](docs/sdks/riskyield/README.md#risk_yield_create_account) - Create account
-* [risk_yield_transfer](docs/sdks/riskyield/README.md#risk_yield_transfer) - Transfer tokens to/from account
-* [risk_yield_swap](docs/sdks/riskyield/README.md#risk_yield_swap) - Swap tokens
-* [risk_yield_mint](docs/sdks/riskyield/README.md#risk_yield_mint) - Open a position
-* [risk_yield_increase](docs/sdks/riskyield/README.md#risk_yield_increase) - Add to a position
-* [risk_yield_decrease](docs/sdks/riskyield/README.md#risk_yield_decrease) - Withdraw from a position
-* [risk_yield_collect](docs/sdks/riskyield/README.md#risk_yield_collect) - Collect fees
-* [risk_yield_rebalance](docs/sdks/riskyield/README.md#risk_yield_rebalance) - Rebalance a position
-
 ### [Sky](docs/sdks/sky/README.md)
 
 * [sky_position](docs/sdks/sky/README.md#sky_position) - Check USDS Position
@@ -505,8 +490,8 @@ with CompassAPI(
 
 
 **Inherit from [`CompassAPIError`](./src/compass_api_sdk/errors/compassapierror.py)**:
-* [`TokenizedAssetsErrorResponse`](./src/compass_api_sdk/errors/tokenizedassetserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 12 of 152 methods.*
-* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 152 methods.*
+* [`TokenizedAssetsErrorResponse`](./src/compass_api_sdk/errors/tokenizedassetserrorresponse.py): Standard error envelope returned by every non-2xx response.  Surfaced in OpenAPI ``responses`` declarations so SDK consumers can decode failures uniformly without inspecting per-status-code shapes. Applicable to 12 of 140 methods.*
+* [`MintPrepareNotFoundResponseError`](./src/compass_api_sdk/errors/mintpreparenotfoundresponseerror.py): Response when the burn event has not been found yet.  This means the burn transaction hasn't been confirmed on-chain yet, or the user hasn't broadcast the burn transaction. Status code `404`. Applicable to 1 of 140 methods.*
 * [`ResponseValidationError`](./src/compass_api_sdk/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "compass_api_sdk"
-version = "2.2.109"
+version = "2.2.110"
 description = "Compass API SDK."
 authors = [{ name = "royalnine" },]
 readme = "README-PYPI.md"
@@ -14,7 +14,7 @@ dependencies = [
 
 [tool.poetry]
 name = "compass_api_sdk"
-version = "2.2.109"
+version = "2.2.110"
 description = "Compass API SDK."
 authors = ["Compass Labs"]
 repository = "https://github.com/CompassLabs/mono.git"

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/src/compass_api_sdk/_version.py

@@ -5,8 +5,8 @@ import importlib.metadata
 __title__: str = "compass_api_sdk"
 __version__: str = "2.0.0"
 __openapi_doc_version__: str = "0.0.1"
-__gen_version__: str = "2.935.1"
-__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.935.1 0.0.1 compass_api_sdk"
+__gen_version__: str = "2.937.18"
+__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.937.18 0.0.1 compass_api_sdk"
 
 try:
     if __package__ is not None:

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/src/compass_api_sdk/credit.py

@@ -2787,6 +2787,258 @@ class Credit(BaseSDK):
 
         raise errors.APIError("Unexpected response received", http_res)
 
+    def credit_swap(
+        self,
+        *,
+        token_in: str,
+        token_out: str,
+        amount_in: Union[
+            models.CreditSwapRequestAmountIn, models.CreditSwapRequestAmountInTypedDict
+        ],
+        owner: str,
+        chain: models.CreditSwapRequestChain,
+        slippage: Optional[
+            Union[
+                models.CreditSwapRequestSlippage,
+                models.CreditSwapRequestSlippageTypedDict,
+            ]
+        ] = None,
+        gas_sponsorship: Optional[bool] = None,
+        pricing: Optional[models.CreditSwapRequestPricing] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.CreditSwapResponse:
+        r"""Swap tokens
+
+        Swap one token for another inside a Credit Account.
+
+        Exchanges tokens the Credit Account already holds in a single atomic
+        transaction, so idle or borrowed balances can be converted without moving
+        funds out first. Returns an unsigned transaction to sign, the expected
+        output amount, and which route priced the swap.
+
+        :param token_in: Token to sell (input). Provide a token symbol from a limited set (e.g., 'USDC') or any token address.
+        :param token_out: Token to buy (output). Provide a token symbol from a limited set (e.g., 'USDT') or any token address.
+        :param amount_in: Human-readable amount of `token_in` to swap (token units, not wei).
+        :param owner: The owner's wallet address. Their Credit Account must already exist (create it with `/v2/credit/create_account`) and hold `token_in` (deposit with `/v2/credit/transfer`).
+        :param chain: Target blockchain network where the swap will execute.
+        :param slippage: Maximum slippage tolerance as a percentage (e.g., 0.5 = 0.5%). Bounds the market route only; a firm quote fills exactly and ignores it.
+        :param gas_sponsorship: Optionally request gas sponsorship. If `true`, EIP-712 typed data will be returned that must be signed by the `owner` and submitted to the 'Prepare gas-sponsored transaction' endpoint (`/gas_sponsorship/prepare`). Gas-sponsored builds always execute at market rate.
+        :param pricing: Swap routing policy. 'auto': a firm zero-slippage quote when a firm venue covers the pair, transparent fallback to the market aggregator otherwise. 'firm': never price on the market route; an uncovered pair fails with a typed error instead of silently substituting market pricing. 'market': never route through the firm venue; the swap is priced by the aggregator and bounded by `slippage` (which firm fills ignore). 'firm' is incompatible with gas_sponsorship (sponsored swaps force market routing).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.CreditSwapRequest(
+            token_in=token_in,
+            token_out=token_out,
+            amount_in=amount_in,
+            slippage=slippage,
+            owner=owner,
+            chain=chain,
+            gas_sponsorship=gas_sponsorship,
+            pricing=pricing,
+        )
+
+        req = self._build_request(
+            method="POST",
+            path="/v2/credit/swap",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request, False, False, "json", models.CreditSwapRequest
+            ),
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="v2_credit_swap",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+                tags=["Credit"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.CreditSwapResponse, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
+    async def credit_swap_async(
+        self,
+        *,
+        token_in: str,
+        token_out: str,
+        amount_in: Union[
+            models.CreditSwapRequestAmountIn, models.CreditSwapRequestAmountInTypedDict
+        ],
+        owner: str,
+        chain: models.CreditSwapRequestChain,
+        slippage: Optional[
+            Union[
+                models.CreditSwapRequestSlippage,
+                models.CreditSwapRequestSlippageTypedDict,
+            ]
+        ] = None,
+        gas_sponsorship: Optional[bool] = None,
+        pricing: Optional[models.CreditSwapRequestPricing] = None,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.CreditSwapResponse:
+        r"""Swap tokens
+
+        Swap one token for another inside a Credit Account.
+
+        Exchanges tokens the Credit Account already holds in a single atomic
+        transaction, so idle or borrowed balances can be converted without moving
+        funds out first. Returns an unsigned transaction to sign, the expected
+        output amount, and which route priced the swap.
+
+        :param token_in: Token to sell (input). Provide a token symbol from a limited set (e.g., 'USDC') or any token address.
+        :param token_out: Token to buy (output). Provide a token symbol from a limited set (e.g., 'USDT') or any token address.
+        :param amount_in: Human-readable amount of `token_in` to swap (token units, not wei).
+        :param owner: The owner's wallet address. Their Credit Account must already exist (create it with `/v2/credit/create_account`) and hold `token_in` (deposit with `/v2/credit/transfer`).
+        :param chain: Target blockchain network where the swap will execute.
+        :param slippage: Maximum slippage tolerance as a percentage (e.g., 0.5 = 0.5%). Bounds the market route only; a firm quote fills exactly and ignores it.
+        :param gas_sponsorship: Optionally request gas sponsorship. If `true`, EIP-712 typed data will be returned that must be signed by the `owner` and submitted to the 'Prepare gas-sponsored transaction' endpoint (`/gas_sponsorship/prepare`). Gas-sponsored builds always execute at market rate.
+        :param pricing: Swap routing policy. 'auto': a firm zero-slippage quote when a firm venue covers the pair, transparent fallback to the market aggregator otherwise. 'firm': never price on the market route; an uncovered pair fails with a typed error instead of silently substituting market pricing. 'market': never route through the firm venue; the swap is priced by the aggregator and bounded by `slippage` (which firm fills ignore). 'firm' is incompatible with gas_sponsorship (sponsored swaps force market routing).
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+
+        request = models.CreditSwapRequest(
+            token_in=token_in,
+            token_out=token_out,
+            amount_in=amount_in,
+            slippage=slippage,
+            owner=owner,
+            chain=chain,
+            gas_sponsorship=gas_sponsorship,
+            pricing=pricing,
+        )
+
+        req = self._build_request_async(
+            method="POST",
+            path="/v2/credit/swap",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=request,
+            request_body_required=True,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            get_serialized_body=lambda: utils.serialize_request_body(
+                request, False, False, "json", models.CreditSwapRequest
+            ),
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="v2_credit_swap",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+                tags=["Credit"],
+                extensions=None,
+            ),
+            request=req,
+            is_error_status_code=lambda c: utils.match_status_codes(["4XX", "5XX"], c),
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/json"):
+            return unmarshal_json_response(models.CreditSwapResponse, http_res)
+        if utils.match_response(http_res, "422", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
+            )
+            raise errors.HTTPValidationError(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise errors.APIError("API error occurred", http_res, http_res_text)
+
+        raise errors.APIError("Unexpected response received", http_res)
+
     def credit_repay(
         self,
         *,

{compass_api_sdk-2.2.109 → compass_api_sdk-2.2.110}/src/compass_api_sdk/earn.py

@@ -416,10 +416,7 @@ class Earn(BaseSDK):
             Union[models.V2EarnVaultsMinTvlUsd, models.V2EarnVaultsMinTvlUsdTypedDict]
         ] = UNSET,
         min_liquidity_usd: OptionalNullable[
-            Union[
-                models.V2EarnVaultsMinLiquidityUsd,
-                models.V2EarnVaultsMinLiquidityUsdTypedDict,
-            ]
+            Union[models.MinLiquidityUsd, models.MinLiquidityUsdTypedDict]
         ] = UNSET,
         min_deposit_cap_usd: OptionalNullable[
             Union[models.MinDepositCapUsd, models.MinDepositCapUsdTypedDict]
@@ -545,10 +542,7 @@ class Earn(BaseSDK):
             Union[models.V2EarnVaultsMinTvlUsd, models.V2EarnVaultsMinTvlUsdTypedDict]
         ] = UNSET,
         min_liquidity_usd: OptionalNullable[
-            Union[
-                models.V2EarnVaultsMinLiquidityUsd,
-                models.V2EarnVaultsMinLiquidityUsdTypedDict,
-            ]
+            Union[models.MinLiquidityUsd, models.MinLiquidityUsdTypedDict]
         ] = UNSET,
         min_deposit_cap_usd: OptionalNullable[
             Union[models.MinDepositCapUsd, models.MinDepositCapUsdTypedDict]
@@ -2304,15 +2298,15 @@ class Earn(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.EarnSwapResponse:
-        r"""Swap tokens within Earn Account
+        r"""Swap tokens
 
-        Swap tokens within an Earn Account.
+        Swap one token for another inside an Earn Account.
 
-        Use this endpoint to exchange one token for another without transferring funds out of the Earn Account.
-
-        The swap executes atomically within the Earn Account and can be combined with other actions using the [bundle endpoint](https://docs.compasslabs.ai/v2/api-reference/earn/execute-multiple-earn-actions). For example, swap ETH to USDC, then deposit USDC into a vault—all in one transaction.
-
-        Returns either an unsigned transaction (when `gas_sponsorship=false`) or EIP-712 typed data for off-chain signing (when `gas_sponsorship=true`). For gas-sponsored swaps, submit the signed typed data to `/gas_sponsorship/prepare`.
+        Exchanges tokens the Earn Account already holds in a single atomic
+        transaction, so funds never leave it, and can be chained with other actions
+        through the [bundle endpoint](https://docs.compasslabs.ai/v2/api-reference/earn/execute-multiple-earn-actions)
+        (for example, swap ETH to USDC and deposit the USDC into a vault at once).
+        Returns an unsigned transaction to sign and the expected output amount.
 
         :param token_in: Token to sell (input). Provide a token symbol from a limited set (e.g., 'USDC') or any token address.
         :param token_out: Token to buy (output). Provide a token symbol from a limited set (e.g., 'USDT') or any token address.
@@ -2427,15 +2421,15 @@ class Earn(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.EarnSwapResponse:
-        r"""Swap tokens within Earn Account
-
-        Swap tokens within an Earn Account.
-
-        Use this endpoint to exchange one token for another without transferring funds out of the Earn Account.
+        r"""Swap tokens
 
-        The swap executes atomically within the Earn Account and can be combined with other actions using the [bundle endpoint](https://docs.compasslabs.ai/v2/api-reference/earn/execute-multiple-earn-actions). For example, swap ETH to USDC, then deposit USDC into a vault—all in one transaction.
+        Swap one token for another inside an Earn Account.
 
-        Returns either an unsigned transaction (when `gas_sponsorship=false`) or EIP-712 typed data for off-chain signing (when `gas_sponsorship=true`). For gas-sponsored swaps, submit the signed typed data to `/gas_sponsorship/prepare`.
+        Exchanges tokens the Earn Account already holds in a single atomic
+        transaction, so funds never leave it, and can be chained with other actions
+        through the [bundle endpoint](https://docs.compasslabs.ai/v2/api-reference/earn/execute-multiple-earn-actions)
+        (for example, swap ETH to USDC and deposit the USDC into a vault at once).
+        Returns an unsigned transaction to sign and the expected output amount.
 
         :param token_in: Token to sell (input). Provide a token symbol from a limited set (e.g., 'USDC') or any token address.
         :param token_out: Token to buy (output). Provide a token symbol from a limited set (e.g., 'USDT') or any token address.