compass_api_sdk 2.2.62__tar.gz → 2.2.63__tar.gz

{compass_api_sdk-2.2.62 → compass_api_sdk-2.2.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compass_api_sdk
-Version: 2.2.62
+Version: 2.2.63
 Summary: Compass API SDK.
 Author: royalnine
 Requires-Python: >=3.10
@@ -353,6 +353,7 @@ with CompassAPI(
 * [tokenized_assets_positions](docs/sdks/tokenizedassets/README.md#tokenized_assets_positions) - Get tokenized-asset positions for an owner
 * [tokenized_assets_order_order_hash_](docs/sdks/tokenizedassets/README.md#tokenized_assets_order_order_hash_) - Get order status
 * [tokenized_assets_create_account](docs/sdks/tokenizedassets/README.md#tokenized_assets_create_account) - Create a Tokenized Assets Account
+* [tokenized_assets_transfer](docs/sdks/tokenizedassets/README.md#tokenized_assets_transfer) - Deposit to / withdraw from a Tokenized Assets Account
 * [tokenized_assets_quote](docs/sdks/tokenizedassets/README.md#tokenized_assets_quote) - Preview a buy/sell quote
 * [tokenized_assets_order](docs/sdks/tokenizedassets/README.md#tokenized_assets_order) - Build a buy/sell order
 * [tokenized_assets_order_submit](docs/sdks/tokenizedassets/README.md#tokenized_assets_order_submit) - Submit a signed order
@@ -496,8 +497,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 10 of 128 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 128 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 11 of 129 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 129 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.62 → compass_api_sdk-2.2.63}/README-PYPI.md

@@ -335,6 +335,7 @@ with CompassAPI(
 * [tokenized_assets_positions](docs/sdks/tokenizedassets/README.md#tokenized_assets_positions) - Get tokenized-asset positions for an owner
 * [tokenized_assets_order_order_hash_](docs/sdks/tokenizedassets/README.md#tokenized_assets_order_order_hash_) - Get order status
 * [tokenized_assets_create_account](docs/sdks/tokenizedassets/README.md#tokenized_assets_create_account) - Create a Tokenized Assets Account
+* [tokenized_assets_transfer](docs/sdks/tokenizedassets/README.md#tokenized_assets_transfer) - Deposit to / withdraw from a Tokenized Assets Account
 * [tokenized_assets_quote](docs/sdks/tokenizedassets/README.md#tokenized_assets_quote) - Preview a buy/sell quote
 * [tokenized_assets_order](docs/sdks/tokenizedassets/README.md#tokenized_assets_order) - Build a buy/sell order
 * [tokenized_assets_order_submit](docs/sdks/tokenizedassets/README.md#tokenized_assets_order_submit) - Submit a signed order
@@ -478,8 +479,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 10 of 128 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 128 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 11 of 129 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 129 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.62 → compass_api_sdk-2.2.63}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "compass_api_sdk"
-version = "2.2.62"
+version = "2.2.63"
 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.62"
+version = "2.2.63"
 description = "Compass API SDK."
 authors = ["Compass Labs"]
 repository = "https://github.com/CompassLabs/mono.git"

{compass_api_sdk-2.2.62 → compass_api_sdk-2.2.63}/src/compass_api_sdk/models/__init__.py

@@ -1220,6 +1220,19 @@ if TYPE_CHECKING:
         TokenizedAssetsTradeResponse,
         TokenizedAssetsTradeResponseTypedDict,
     )
+    from .tokenizedassetstransferrequest import (
+        TokenizedAssetsTransferRequest,
+        TokenizedAssetsTransferRequestAction,
+        TokenizedAssetsTransferRequestAmount,
+        TokenizedAssetsTransferRequestAmountTypedDict,
+        TokenizedAssetsTransferRequestTypedDict,
+    )
+    from .tokenizedassetstransferresponse import (
+        TokenizedAssetsTransferResponse,
+        TokenizedAssetsTransferResponseEip712,
+        TokenizedAssetsTransferResponseEip712TypedDict,
+        TokenizedAssetsTransferResponseTypedDict,
+    )
     from .tokenlistresponse import TokenListResponse, TokenListResponseTypedDict
     from .tokenmarketdata import TokenMarketData, TokenMarketDataTypedDict
     from .tokenpermissions import TokenPermissions, TokenPermissionsTypedDict
@@ -2657,6 +2670,15 @@ __all__ = [
     "TokenizedAssetsTradeRequestTypedDict",
     "TokenizedAssetsTradeResponse",
     "TokenizedAssetsTradeResponseTypedDict",
+    "TokenizedAssetsTransferRequest",
+    "TokenizedAssetsTransferRequestAction",
+    "TokenizedAssetsTransferRequestAmount",
+    "TokenizedAssetsTransferRequestAmountTypedDict",
+    "TokenizedAssetsTransferRequestTypedDict",
+    "TokenizedAssetsTransferResponse",
+    "TokenizedAssetsTransferResponseEip712",
+    "TokenizedAssetsTransferResponseEip712TypedDict",
+    "TokenizedAssetsTransferResponseTypedDict",
     "TransactionResponse",
     "TransactionResponseTransaction",
     "TransactionResponseTransactionTypedDict",
@@ -3870,6 +3892,15 @@ _dynamic_imports: dict[str, str] = {
     "TokenizedAssetsTradeRequestTypedDict": ".tokenizedassetstraderequest",
     "TokenizedAssetsTradeResponse": ".tokenizedassetstraderesponse",
     "TokenizedAssetsTradeResponseTypedDict": ".tokenizedassetstraderesponse",
+    "TokenizedAssetsTransferRequest": ".tokenizedassetstransferrequest",
+    "TokenizedAssetsTransferRequestAction": ".tokenizedassetstransferrequest",
+    "TokenizedAssetsTransferRequestAmount": ".tokenizedassetstransferrequest",
+    "TokenizedAssetsTransferRequestAmountTypedDict": ".tokenizedassetstransferrequest",
+    "TokenizedAssetsTransferRequestTypedDict": ".tokenizedassetstransferrequest",
+    "TokenizedAssetsTransferResponse": ".tokenizedassetstransferresponse",
+    "TokenizedAssetsTransferResponseEip712": ".tokenizedassetstransferresponse",
+    "TokenizedAssetsTransferResponseEip712TypedDict": ".tokenizedassetstransferresponse",
+    "TokenizedAssetsTransferResponseTypedDict": ".tokenizedassetstransferresponse",
     "TokenListResponse": ".tokenlistresponse",
     "TokenListResponseTypedDict": ".tokenlistresponse",
     "TokenMarketData": ".tokenmarketdata",

compass_api_sdk-2.2.63/src/compass_api_sdk/models/tokenizedassetstransferrequest.py

@@ -0,0 +1,99 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .chain import Chain
+from compass_api_sdk.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
+from enum import Enum
+from pydantic import model_serializer
+from typing import Optional, Union
+from typing_extensions import NotRequired, TypeAliasType, TypedDict
+
+
+TokenizedAssetsTransferRequestAmountTypedDict = TypeAliasType(
+    "TokenizedAssetsTransferRequestAmountTypedDict", Union[float, str]
+)
+r"""The amount of tokens to transfer (in token units, not wei)."""
+
+
+TokenizedAssetsTransferRequestAmount = TypeAliasType(
+    "TokenizedAssetsTransferRequestAmount", Union[float, str]
+)
+r"""The amount of tokens to transfer (in token units, not wei)."""
+
+
+class TokenizedAssetsTransferRequestAction(str, Enum):
+    r"""Whether you are depositing to or withdrawing from your Tokenized Assets Account."""
+
+    DEPOSIT = "DEPOSIT"
+    WITHDRAW = "WITHDRAW"
+
+
+class TokenizedAssetsTransferRequestTypedDict(TypedDict):
+    owner: str
+    r"""The owner's wallet address (EOA)."""
+    token: str
+    r"""The token to transfer. Tokenized-asset orders settle in USDC."""
+    amount: TokenizedAssetsTransferRequestAmountTypedDict
+    r"""The amount of tokens to transfer (in token units, not wei)."""
+    action: TokenizedAssetsTransferRequestAction
+    r"""Whether you are depositing to or withdrawing from your Tokenized Assets Account."""
+    chain: NotRequired[Chain]
+    r"""The chain to use."""
+    gas_sponsorship: NotRequired[bool]
+    r"""Optionally request gas sponsorship. If set to `true`, EIP-712 signature data will be returned that must be signed by the `owner` and submitted to the `/gas_sponsorship/prepare` endpoint."""
+    spender: NotRequired[Nullable[str]]
+    r"""The address that will call Permit2's permitTransferFrom to execute the transfer. When `action` is 'DEPOSIT' and `gas_sponsorship` is `true`: - If provided, the signature will authorize this address (typically a gas sponsor) to pull tokens. - If not provided, defaults to the Tokenized Assets Account (Safe) address, allowing the transfer to be included in a bundle transaction where the Safe pulls the tokens itself."""
+
+
+class TokenizedAssetsTransferRequest(BaseModel):
+    owner: str
+    r"""The owner's wallet address (EOA)."""
+
+    token: str
+    r"""The token to transfer. Tokenized-asset orders settle in USDC."""
+
+    amount: TokenizedAssetsTransferRequestAmount
+    r"""The amount of tokens to transfer (in token units, not wei)."""
+
+    action: TokenizedAssetsTransferRequestAction
+    r"""Whether you are depositing to or withdrawing from your Tokenized Assets Account."""
+
+    chain: Optional[Chain] = None
+    r"""The chain to use."""
+
+    gas_sponsorship: Optional[bool] = None
+    r"""Optionally request gas sponsorship. If set to `true`, EIP-712 signature data will be returned that must be signed by the `owner` and submitted to the `/gas_sponsorship/prepare` endpoint."""
+
+    spender: OptionalNullable[str] = UNSET
+    r"""The address that will call Permit2's permitTransferFrom to execute the transfer. When `action` is 'DEPOSIT' and `gas_sponsorship` is `true`: - If provided, the signature will authorize this address (typically a gas sponsor) to pull tokens. - If not provided, defaults to the Tokenized Assets Account (Safe) address, allowing the transfer to be included in a bundle transaction where the Safe pulls the tokens itself."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["chain", "gas_sponsorship", "spender"])
+        nullable_fields = set(["spender"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m

compass_api_sdk-2.2.63/src/compass_api_sdk/models/tokenizedassetstransferresponse.py

@@ -0,0 +1,78 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .batchedsafeoperationsresponse_output import (
+    BatchedSafeOperationsResponseOutput,
+    BatchedSafeOperationsResponseOutputTypedDict,
+)
+from .permit2typeddata_output import (
+    Permit2TypedDataOutput,
+    Permit2TypedDataOutputTypedDict,
+)
+from .unsignedtransaction import UnsignedTransaction, UnsignedTransactionTypedDict
+from compass_api_sdk.types import (
+    BaseModel,
+    Nullable,
+    OptionalNullable,
+    UNSET,
+    UNSET_SENTINEL,
+)
+from pydantic import model_serializer
+from typing import Union
+from typing_extensions import NotRequired, TypeAliasType, TypedDict
+
+
+TokenizedAssetsTransferResponseEip712TypedDict = TypeAliasType(
+    "TokenizedAssetsTransferResponseEip712TypedDict",
+    Union[
+        BatchedSafeOperationsResponseOutputTypedDict, Permit2TypedDataOutputTypedDict
+    ],
+)
+r"""EIP-712 typed data for gas-sponsored execution. Present when `gas_sponsorship=true`. A Permit2 `PermitTransferFrom` for DEPOSIT, or a Safe transaction for WITHDRAW. The owner signs it and submits to `/v2/gas_sponsorship/prepare`."""
+
+
+TokenizedAssetsTransferResponseEip712 = TypeAliasType(
+    "TokenizedAssetsTransferResponseEip712",
+    Union[BatchedSafeOperationsResponseOutput, Permit2TypedDataOutput],
+)
+r"""EIP-712 typed data for gas-sponsored execution. Present when `gas_sponsorship=true`. A Permit2 `PermitTransferFrom` for DEPOSIT, or a Safe transaction for WITHDRAW. The owner signs it and submits to `/v2/gas_sponsorship/prepare`."""
+
+
+class TokenizedAssetsTransferResponseTypedDict(TypedDict):
+    transaction: NotRequired[Nullable[UnsignedTransactionTypedDict]]
+    r"""Unsigned transaction for direct execution. Present when `gas_sponsorship=false`."""
+    eip_712: NotRequired[Nullable[TokenizedAssetsTransferResponseEip712TypedDict]]
+    r"""EIP-712 typed data for gas-sponsored execution. Present when `gas_sponsorship=true`. A Permit2 `PermitTransferFrom` for DEPOSIT, or a Safe transaction for WITHDRAW. The owner signs it and submits to `/v2/gas_sponsorship/prepare`."""
+
+
+class TokenizedAssetsTransferResponse(BaseModel):
+    transaction: OptionalNullable[UnsignedTransaction] = UNSET
+    r"""Unsigned transaction for direct execution. Present when `gas_sponsorship=false`."""
+
+    eip_712: OptionalNullable[TokenizedAssetsTransferResponseEip712] = UNSET
+    r"""EIP-712 typed data for gas-sponsored execution. Present when `gas_sponsorship=true`. A Permit2 `PermitTransferFrom` for DEPOSIT, or a Safe transaction for WITHDRAW. The owner signs it and submits to `/v2/gas_sponsorship/prepare`."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["transaction", "eip_712"])
+        nullable_fields = set(["transaction", "eip_712"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+            is_nullable_and_explicitly_set = (
+                k in nullable_fields
+                and (self.__pydantic_fields_set__.intersection({n}))  # pylint: disable=no-member
+            )
+
+            if val != UNSET_SENTINEL:
+                if (
+                    val is not None
+                    or k not in optional_fields
+                    or is_nullable_and_explicitly_set
+                ):
+                    m[k] = val
+
+        return m

{compass_api_sdk-2.2.62 → compass_api_sdk-2.2.63}/src/compass_api_sdk/tokenized_assets.py

@@ -1157,6 +1157,278 @@ class TokenizedAssets(BaseSDK):
 
         raise errors.APIError("Unexpected response received", http_res)
 
+    def tokenized_assets_transfer(
+        self,
+        *,
+        owner: str,
+        token: str,
+        amount: Union[
+            models.TokenizedAssetsTransferRequestAmount,
+            models.TokenizedAssetsTransferRequestAmountTypedDict,
+        ],
+        action: models.TokenizedAssetsTransferRequestAction,
+        chain: Optional[models.Chain] = None,
+        gas_sponsorship: Optional[bool] = None,
+        spender: OptionalNullable[str] = UNSET,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.TokenizedAssetsTransferResponse:
+        r"""Deposit to / withdraw from a Tokenized Assets Account
+
+        Move tokens between the owner's wallet and their Tokenized Assets Account.
+
+        Use `DEPOSIT` to fund the account from the owner's wallet, or `WITHDRAW` to
+        send tokens from the account back to the owner. Equity orders settle in
+        USDC; RWA yield assets trade against USDC on Ethereum and Base.
+
+        With `gas_sponsorship=true` the response is EIP-712 typed data the owner
+        signs off-chain, then submits to `POST /v2/gas_sponsorship/prepare` so the
+        sponsor broadcasts and pays the gas:
+
+        - **DEPOSIT** returns a Permit2 `PermitTransferFrom`. The owner must first
+        grant a one-time token->Permit2 allowance (gaslessly via
+        `POST /v2/gas_sponsorship/approve_transfer`).
+        - **WITHDRAW** returns a Safe transaction the account executes.
+
+        With `gas_sponsorship=false` a DEPOSIT returns an unsigned ERC-20 transfer
+        the owner broadcasts directly, and a WITHDRAW returns an unsigned Safe
+        `execTransaction` the owner signs and broadcasts.
+
+        :param owner: The owner's wallet address (EOA).
+        :param token: The token to transfer. Tokenized-asset orders settle in USDC.
+        :param amount: The amount of tokens to transfer (in token units, not wei).
+        :param action: Whether you are depositing to or withdrawing from your Tokenized Assets Account.
+        :param chain: The chain to use.
+        :param gas_sponsorship: Optionally request gas sponsorship. If set to `true`, EIP-712 signature data will be returned that must be signed by the `owner` and submitted to the `/gas_sponsorship/prepare` endpoint.
+        :param spender: The address that will call Permit2's permitTransferFrom to execute the transfer. When `action` is 'DEPOSIT' and `gas_sponsorship` is `true`: - If provided, the signature will authorize this address (typically a gas sponsor) to pull tokens. - If not provided, defaults to the Tokenized Assets Account (Safe) address, allowing the transfer to be included in a bundle transaction where the Safe pulls the tokens itself.
+        :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.TokenizedAssetsTransferRequest(
+            owner=owner,
+            chain=chain,
+            token=token,
+            amount=amount,
+            action=action,
+            gas_sponsorship=gas_sponsorship,
+            spender=spender,
+        )
+
+        req = self._build_request(
+            method="POST",
+            path="/v2/tokenized_assets/transfer",
+            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.TokenizedAssetsTransferRequest
+            ),
+            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_tokenized_assets_transfer",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            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.TokenizedAssetsTransferResponse, http_res
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.TokenizedAssetsErrorResponseData, http_res
+            )
+            raise errors.TokenizedAssetsErrorResponse(response_data, 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 tokenized_assets_transfer_async(
+        self,
+        *,
+        owner: str,
+        token: str,
+        amount: Union[
+            models.TokenizedAssetsTransferRequestAmount,
+            models.TokenizedAssetsTransferRequestAmountTypedDict,
+        ],
+        action: models.TokenizedAssetsTransferRequestAction,
+        chain: Optional[models.Chain] = None,
+        gas_sponsorship: Optional[bool] = None,
+        spender: OptionalNullable[str] = UNSET,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.TokenizedAssetsTransferResponse:
+        r"""Deposit to / withdraw from a Tokenized Assets Account
+
+        Move tokens between the owner's wallet and their Tokenized Assets Account.
+
+        Use `DEPOSIT` to fund the account from the owner's wallet, or `WITHDRAW` to
+        send tokens from the account back to the owner. Equity orders settle in
+        USDC; RWA yield assets trade against USDC on Ethereum and Base.
+
+        With `gas_sponsorship=true` the response is EIP-712 typed data the owner
+        signs off-chain, then submits to `POST /v2/gas_sponsorship/prepare` so the
+        sponsor broadcasts and pays the gas:
+
+        - **DEPOSIT** returns a Permit2 `PermitTransferFrom`. The owner must first
+        grant a one-time token->Permit2 allowance (gaslessly via
+        `POST /v2/gas_sponsorship/approve_transfer`).
+        - **WITHDRAW** returns a Safe transaction the account executes.
+
+        With `gas_sponsorship=false` a DEPOSIT returns an unsigned ERC-20 transfer
+        the owner broadcasts directly, and a WITHDRAW returns an unsigned Safe
+        `execTransaction` the owner signs and broadcasts.
+
+        :param owner: The owner's wallet address (EOA).
+        :param token: The token to transfer. Tokenized-asset orders settle in USDC.
+        :param amount: The amount of tokens to transfer (in token units, not wei).
+        :param action: Whether you are depositing to or withdrawing from your Tokenized Assets Account.
+        :param chain: The chain to use.
+        :param gas_sponsorship: Optionally request gas sponsorship. If set to `true`, EIP-712 signature data will be returned that must be signed by the `owner` and submitted to the `/gas_sponsorship/prepare` endpoint.
+        :param spender: The address that will call Permit2's permitTransferFrom to execute the transfer. When `action` is 'DEPOSIT' and `gas_sponsorship` is `true`: - If provided, the signature will authorize this address (typically a gas sponsor) to pull tokens. - If not provided, defaults to the Tokenized Assets Account (Safe) address, allowing the transfer to be included in a bundle transaction where the Safe pulls the tokens itself.
+        :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.TokenizedAssetsTransferRequest(
+            owner=owner,
+            chain=chain,
+            token=token,
+            amount=amount,
+            action=action,
+            gas_sponsorship=gas_sponsorship,
+            spender=spender,
+        )
+
+        req = self._build_request_async(
+            method="POST",
+            path="/v2/tokenized_assets/transfer",
+            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.TokenizedAssetsTransferRequest
+            ),
+            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_tokenized_assets_transfer",
+                oauth2_scopes=None,
+                security_source=self.sdk_configuration.security,
+            ),
+            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.TokenizedAssetsTransferResponse, http_res
+            )
+        if utils.match_response(http_res, "400", "application/json"):
+            response_data = unmarshal_json_response(
+                errors.TokenizedAssetsErrorResponseData, http_res
+            )
+            raise errors.TokenizedAssetsErrorResponse(response_data, 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 tokenized_assets_quote(
         self,
         *,