compass_api_sdk 0.9.35__py3-none-any.whl → 2.0.21rc1__py3-none-any.whl

compass_api_sdk/sky.py

@@ -4,14 +4,16 @@ from .basesdk import BaseSDK
 from compass_api_sdk import errors, models, utils
 from compass_api_sdk._hooks import HookContext
 from compass_api_sdk.types import OptionalNullable, UNSET
+from compass_api_sdk.utils.unmarshal_json_response import unmarshal_json_response
 from typing import Any, Mapping, Optional, Union
 
 
 class Sky(BaseSDK):
-    def position(
+    def sky_position(
         self,
         *,
-        user_address: str = "0xa829B388A3DF7f581cE957a95edbe419dd146d1B",
+        chain: models.V1SkyPositionChain,
+        user_address: str,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -21,7 +23,8 @@ class Sky(BaseSDK):
 
         Check the USDS overall position.
 
-        :param user_address: The user address of the desired position.
+        :param chain:
+        :param user_address: The user-address of the desired position.
         :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
@@ -37,13 +40,14 @@ class Sky(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.SkyPositionRequest(
+        request = models.V1SkyPositionRequest(
+            chain=chain,
             user_address=user_address,
         )
 
         req = self._build_request(
             method="GET",
-            path="/v0/sky/position",
+            path="/v1/sky/position",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -54,6 +58,7 @@ class Sky(BaseSDK):
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -69,8 +74,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_position",
-                oauth2_scopes=[],
+                operation_id="v1_sky_position",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -80,36 +85,26 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.SkyCheckPositionResponse)
+            return unmarshal_json_response(models.SkyCheckPositionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = utils.stream_to_text(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    async def position_async(
+    async def sky_position_async(
         self,
         *,
-        user_address: str = "0xa829B388A3DF7f581cE957a95edbe419dd146d1B",
+        chain: models.V1SkyPositionChain,
+        user_address: str,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -119,7 +114,8 @@ class Sky(BaseSDK):
 
         Check the USDS overall position.
 
-        :param user_address: The user address of the desired position.
+        :param chain:
+        :param user_address: The user-address of the desired position.
         :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
@@ -135,13 +131,14 @@ class Sky(BaseSDK):
         else:
             base_url = self._get_url(base_url, url_variables)
 
-        request = models.SkyPositionRequest(
+        request = models.V1SkyPositionRequest(
+            chain=chain,
             user_address=user_address,
         )
 
         req = self._build_request_async(
             method="GET",
-            path="/v0/sky/position",
+            path="/v1/sky/position",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -152,6 +149,7 @@ class Sky(BaseSDK):
             accept_header_value="application/json",
             http_headers=http_headers,
             security=self.sdk_configuration.security,
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -167,8 +165,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_position",
-                oauth2_scopes=[],
+                operation_id="v1_sky_position",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -178,43 +176,34 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.SkyCheckPositionResponse)
+            return unmarshal_json_response(models.SkyCheckPositionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_text, 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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = await utils.stream_to_text_async(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    def buy(
+    def sky_buy(
         self,
         *,
         token_in: models.SkyBuyRequestTokenIn,
         amount: Union[models.SkyBuyRequestAmount, models.SkyBuyRequestAmountTypedDict],
+        chain: models.SkyBuyRequestChain,
         sender: str,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Buy USDS
 
         Buy USDS with DAI or USDC on a 1:1 basis. There are no fees.
@@ -223,11 +212,22 @@ class Sky(BaseSDK):
         'SkyDaiUsdsConverter' contract beforehand.
 
         If buying with USDC, user will need to set an allowance on the USDC contract for the
-        'SkyDaiUsdsConverter' contract beforehand.
+        'SkyUsdcUsdsConverter' contract beforehand.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdcUsdsConverter`
+        - `SkyDaiUsdsConverter`
+        </Info>
+
 
         :param token_in: The token you would like to swap 1:1 for USDS. Choose from DAI or USDC.
         :param amount: The amount of USDS you would like to buy 1:1 with 'token_in'.
+        :param chain:
         :param sender: The address of the transaction sender.
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -246,12 +246,14 @@ class Sky(BaseSDK):
         request = models.SkyBuyRequest(
             token_in=token_in,
             amount=amount,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request(
             method="POST",
-            path="/v0/sky/buy",
+            path="/v1/sky/buy",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -265,6 +267,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyBuyRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -280,8 +283,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_buy",
-                oauth2_scopes=[],
+                operation_id="v1_sky_buy",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -291,43 +294,34 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = utils.stream_to_text(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    async def buy_async(
+    async def sky_buy_async(
         self,
         *,
         token_in: models.SkyBuyRequestTokenIn,
         amount: Union[models.SkyBuyRequestAmount, models.SkyBuyRequestAmountTypedDict],
+        chain: models.SkyBuyRequestChain,
         sender: str,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Buy USDS
 
         Buy USDS with DAI or USDC on a 1:1 basis. There are no fees.
@@ -336,11 +330,22 @@ class Sky(BaseSDK):
         'SkyDaiUsdsConverter' contract beforehand.
 
         If buying with USDC, user will need to set an allowance on the USDC contract for the
-        'SkyDaiUsdsConverter' contract beforehand.
+        'SkyUsdcUsdsConverter' contract beforehand.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdcUsdsConverter`
+        - `SkyDaiUsdsConverter`
+        </Info>
+
 
         :param token_in: The token you would like to swap 1:1 for USDS. Choose from DAI or USDC.
         :param amount: The amount of USDS you would like to buy 1:1 with 'token_in'.
+        :param chain:
         :param sender: The address of the transaction sender.
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -359,12 +364,14 @@ class Sky(BaseSDK):
         request = models.SkyBuyRequest(
             token_in=token_in,
             amount=amount,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v0/sky/buy",
+            path="/v1/sky/buy",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -378,6 +385,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyBuyRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -393,8 +401,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_buy",
-                oauth2_scopes=[],
+                operation_id="v1_sky_buy",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -404,45 +412,36 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_text, 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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = await utils.stream_to_text_async(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    def sell(
+    def sky_sell(
         self,
         *,
         token_out: models.SkySellRequestTokenOut,
         amount: Union[
             models.SkySellRequestAmount, models.SkySellRequestAmountTypedDict
         ],
+        chain: models.SkySellRequestChain,
         sender: str,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Sell USDS
 
         Sell USDS for DAI or USDC on a 1:1 basis. There are no fees.
@@ -452,10 +451,21 @@ class Sky(BaseSDK):
 
         If swapping to USDC, user will need to set an allowance on the USDS contract for the
         'SkyUsdcUsdsConverter' contract beforehand.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdcUsdsConverter`
+        - `SkyDaiUsdsConverter`
+        </Info>
+
 
         :param token_out: The token you would like to swap 1:1 with USDS. Choose from DAI or USDC.
         :param amount: The amount of USDS you would like to sell 1:1 for 'token_out'.
+        :param chain:
         :param sender: The address of the transaction sender.
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -474,12 +484,14 @@ class Sky(BaseSDK):
         request = models.SkySellRequest(
             token_out=token_out,
             amount=amount,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request(
             method="POST",
-            path="/v0/sky/sell",
+            path="/v1/sky/sell",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -493,6 +505,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkySellRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -508,8 +521,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_sell",
-                oauth2_scopes=[],
+                operation_id="v1_sky_sell",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -519,45 +532,36 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = utils.stream_to_text(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    async def sell_async(
+    async def sky_sell_async(
         self,
         *,
         token_out: models.SkySellRequestTokenOut,
         amount: Union[
             models.SkySellRequestAmount, models.SkySellRequestAmountTypedDict
         ],
+        chain: models.SkySellRequestChain,
         sender: str,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Sell USDS
 
         Sell USDS for DAI or USDC on a 1:1 basis. There are no fees.
@@ -567,10 +571,21 @@ class Sky(BaseSDK):
 
         If swapping to USDC, user will need to set an allowance on the USDS contract for the
         'SkyUsdcUsdsConverter' contract beforehand.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdcUsdsConverter`
+        - `SkyDaiUsdsConverter`
+        </Info>
+
 
         :param token_out: The token you would like to swap 1:1 with USDS. Choose from DAI or USDC.
         :param amount: The amount of USDS you would like to sell 1:1 for 'token_out'.
+        :param chain:
         :param sender: The address of the transaction sender.
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -589,12 +604,14 @@ class Sky(BaseSDK):
         request = models.SkySellRequest(
             token_out=token_out,
             amount=amount,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v0/sky/sell",
+            path="/v1/sky/sell",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -608,6 +625,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkySellRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -623,8 +641,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_sell",
-                oauth2_scopes=[],
+                operation_id="v1_sky_sell",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -634,33 +652,22 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_text, 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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = await utils.stream_to_text_async(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    def deposit(
+    def sky_deposit(
         self,
         *,
         amount: Union[
@@ -668,20 +675,34 @@ class Sky(BaseSDK):
         ],
         sender: str,
         receiver: OptionalNullable[str] = UNSET,
+        chain: Optional[models.SkyDepositRequestChain] = None,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Deposit USDS
 
-        Deposit USDS for sUSDS to earn yield.
+        Deposit USDS to earn yield. Deposited USDS is represented as sUSDS.
+
+        Allowance must be set on USDS contract for UsdsVault.
 
         There are no fees.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdsVault`
+        </Info>
+
 
         :param amount: The amount of USDS you would like to deposit for sUSDS to earn yield.
         :param sender: The address of the transaction sender.
         :param receiver: The address which will receive the sUSDS. Defaults to the sender.
+        :param chain:
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -700,12 +721,14 @@ class Sky(BaseSDK):
         request = models.SkyDepositRequest(
             amount=amount,
             receiver=receiver,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request(
             method="POST",
-            path="/v0/sky/deposit",
+            path="/v1/sky/deposit",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -719,6 +742,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyDepositRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -734,8 +758,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_deposit",
-                oauth2_scopes=[],
+                operation_id="v1_sky_deposit",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -745,33 +769,22 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = utils.stream_to_text(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    async def deposit_async(
+    async def sky_deposit_async(
         self,
         *,
         amount: Union[
@@ -779,20 +792,34 @@ class Sky(BaseSDK):
         ],
         sender: str,
         receiver: OptionalNullable[str] = UNSET,
+        chain: Optional[models.SkyDepositRequestChain] = None,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Deposit USDS
 
-        Deposit USDS for sUSDS to earn yield.
+        Deposit USDS to earn yield. Deposited USDS is represented as sUSDS.
+
+        Allowance must be set on USDS contract for UsdsVault.
 
         There are no fees.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdsVault`
+        </Info>
+
 
         :param amount: The amount of USDS you would like to deposit for sUSDS to earn yield.
         :param sender: The address of the transaction sender.
         :param receiver: The address which will receive the sUSDS. Defaults to the sender.
+        :param chain:
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -811,12 +838,14 @@ class Sky(BaseSDK):
         request = models.SkyDepositRequest(
             amount=amount,
             receiver=receiver,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v0/sky/deposit",
+            path="/v1/sky/deposit",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -830,6 +859,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyDepositRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -845,8 +875,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_deposit",
-                oauth2_scopes=[],
+                operation_id="v1_sky_deposit",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -856,50 +886,55 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_text, 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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = await utils.stream_to_text_async(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    def withdraw(
+    def sky_withdraw(
         self,
         *,
         amount: Any,
         sender: str,
         receiver: OptionalNullable[str] = UNSET,
+        chain: Optional[models.SkyWithdrawRequestChain] = None,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Withdraw USDS
 
-        Withdraw USDS for sUSDS to stop earning yield.
+        Withdraw USDS. Exchange yield-bearing sUSDS for USDS.
+
+        Allowance must be set on USDS contract for UsdsVault.
+
+        There are no fees.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdsVault`
+        </Info>
+
 
         :param amount: The amount of USDS you would like to withdraw. If set to 'ALL', your total deposited USDS amount will be withdrawn.
         :param sender: The address of the transaction sender.
         :param receiver: The address which will receive the withdrawn USDS. Defaults to the sender.
+        :param chain:
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -918,12 +953,14 @@ class Sky(BaseSDK):
         request = models.SkyWithdrawRequest(
             amount=amount,
             receiver=receiver,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request(
             method="POST",
-            path="/v0/sky/withdraw",
+            path="/v1/sky/withdraw",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -937,6 +974,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyWithdrawRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -952,8 +990,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_withdraw",
-                oauth2_scopes=[],
+                operation_id="v1_sky_withdraw",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -963,50 +1001,55 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = utils.stream_to_text(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)
 
-    async def withdraw_async(
+    async def sky_withdraw_async(
         self,
         *,
         amount: Any,
         sender: str,
         receiver: OptionalNullable[str] = UNSET,
+        chain: Optional[models.SkyWithdrawRequestChain] = None,
+        estimate_gas: Optional[bool] = None,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
-    ) -> models.TxResponse:
+    ) -> models.TransactionResponse:
         r"""Withdraw USDS
 
-        Withdraw USDS for sUSDS to stop earning yield.
+        Withdraw USDS. Exchange yield-bearing sUSDS for USDS.
+
+        Allowance must be set on USDS contract for UsdsVault.
+
+        There are no fees.
+        <Info>
+        **Required Allowances**
+
+        In order to make this transaction, token allowances need to be set for the following contracts.
+
+        - `SkyUsdsVault`
+        </Info>
+
 
         :param amount: The amount of USDS you would like to withdraw. If set to 'ALL', your total deposited USDS amount will be withdrawn.
         :param sender: The address of the transaction sender.
         :param receiver: The address which will receive the withdrawn USDS. Defaults to the sender.
+        :param chain:
+        :param estimate_gas: Determines whether to estimate gas costs for transactions, also verifying that the transaction can be successfully executed.
         :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
@@ -1025,12 +1068,14 @@ class Sky(BaseSDK):
         request = models.SkyWithdrawRequest(
             amount=amount,
             receiver=receiver,
+            chain=chain,
             sender=sender,
+            estimate_gas=estimate_gas,
         )
 
         req = self._build_request_async(
             method="POST",
-            path="/v0/sky/withdraw",
+            path="/v1/sky/withdraw",
             base_url=base_url,
             url_variables=url_variables,
             request=request,
@@ -1044,6 +1089,7 @@ class Sky(BaseSDK):
             get_serialized_body=lambda: utils.serialize_request_body(
                 request, False, False, "json", models.SkyWithdrawRequest
             ),
+            allow_empty_value=None,
             timeout_ms=timeout_ms,
         )
 
@@ -1059,8 +1105,8 @@ class Sky(BaseSDK):
             hook_ctx=HookContext(
                 config=self.sdk_configuration,
                 base_url=base_url or "",
-                operation_id="sky_withdraw",
-                oauth2_scopes=[],
+                operation_id="v1_sky_withdraw",
+                oauth2_scopes=None,
                 security_source=self.sdk_configuration.security,
             ),
             request=req,
@@ -1070,28 +1116,17 @@ class Sky(BaseSDK):
 
         response_data: Any = None
         if utils.match_response(http_res, "200", "application/json"):
-            return utils.unmarshal_json(http_res.text, models.TxResponse)
+            return unmarshal_json_response(models.TransactionResponse, http_res)
         if utils.match_response(http_res, "422", "application/json"):
-            response_data = utils.unmarshal_json(
-                http_res.text, errors.HTTPValidationErrorData
+            response_data = unmarshal_json_response(
+                errors.HTTPValidationErrorData, http_res
             )
-            raise errors.HTTPValidationError(data=response_data)
+            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.status_code, http_res_text, 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.status_code, http_res_text, http_res
-            )
+            raise errors.APIError("API error occurred", http_res, http_res_text)
 
-        content_type = http_res.headers.get("Content-Type")
-        http_res_text = await utils.stream_to_text_async(http_res)
-        raise errors.APIError(
-            f"Unexpected response received (code: {http_res.status_code}, type: {content_type})",
-            http_res.status_code,
-            http_res_text,
-            http_res,
-        )
+        raise errors.APIError("Unexpected response received", http_res)