compass_api_sdk 2.2.55__tar.gz → 2.2.56rc1__tar.gz

{compass_api_sdk-2.2.55 → compass_api_sdk-2.2.56rc1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: compass_api_sdk
-Version: 2.2.55
+Version: 2.2.56rc1
 Summary: Compass API SDK.
 Author: royalnine
 Requires-Python: >=3.10
@@ -285,6 +285,7 @@ with CompassAPI(
 * [global_markets_perps_candles](docs/sdks/globalmarketsperps/README.md#global_markets_perps_candles) - Get OHLCV candles
 * [global_markets_perps_activity](docs/sdks/globalmarketsperps/README.md#global_markets_perps_activity) - Aggregated Hyperliquid activity for a user
 * [global_markets_perps_deposit](docs/sdks/globalmarketsperps/README.md#global_markets_perps_deposit) - Deposit USDC to global markets perps account
+* [global_markets_perps_deposit_sponsor_prepare](docs/sdks/globalmarketsperps/README.md#global_markets_perps_deposit_sponsor_prepare) - Build the Bridge2 deposit tx from a signed permit
 * [global_markets_perps_withdraw](docs/sdks/globalmarketsperps/README.md#global_markets_perps_withdraw) - Withdraw USDC from global markets perps account
 * [global_markets_perps_market_order](docs/sdks/globalmarketsperps/README.md#global_markets_perps_market_order) - Place market order
 * [global_markets_perps_limit_order](docs/sdks/globalmarketsperps/README.md#global_markets_perps_limit_order) - Place limit order
@@ -492,8 +493,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 8 of 124 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 124 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 8 of 125 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 125 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.55 → compass_api_sdk-2.2.56rc1}/README-PYPI.md

@@ -267,6 +267,7 @@ with CompassAPI(
 * [global_markets_perps_candles](docs/sdks/globalmarketsperps/README.md#global_markets_perps_candles) - Get OHLCV candles
 * [global_markets_perps_activity](docs/sdks/globalmarketsperps/README.md#global_markets_perps_activity) - Aggregated Hyperliquid activity for a user
 * [global_markets_perps_deposit](docs/sdks/globalmarketsperps/README.md#global_markets_perps_deposit) - Deposit USDC to global markets perps account
+* [global_markets_perps_deposit_sponsor_prepare](docs/sdks/globalmarketsperps/README.md#global_markets_perps_deposit_sponsor_prepare) - Build the Bridge2 deposit tx from a signed permit
 * [global_markets_perps_withdraw](docs/sdks/globalmarketsperps/README.md#global_markets_perps_withdraw) - Withdraw USDC from global markets perps account
 * [global_markets_perps_market_order](docs/sdks/globalmarketsperps/README.md#global_markets_perps_market_order) - Place market order
 * [global_markets_perps_limit_order](docs/sdks/globalmarketsperps/README.md#global_markets_perps_limit_order) - Place limit order
@@ -474,8 +475,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 8 of 124 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 124 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 8 of 125 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 125 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.55 → compass_api_sdk-2.2.56rc1}/pyproject.toml

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

{compass_api_sdk-2.2.55 → compass_api_sdk-2.2.56rc1}/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.884.11"
-__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.884.11 0.0.1 compass_api_sdk"
+__gen_version__: str = "2.885.0"
+__user_agent__: str = "speakeasy-sdk/python 2.0.0 2.885.0 0.0.1 compass_api_sdk"
 
 try:
     if __package__ is not None:

{compass_api_sdk-2.2.55 → compass_api_sdk-2.2.56rc1}/src/compass_api_sdk/global_markets_perps.py

@@ -854,8 +854,10 @@ class GlobalMarketsPerps(BaseSDK):
         Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.
 
         Returns EIP-712 typed data for the user to sign off-chain (no gas needed).
-        After signing, send the permit signature to the deposit/execute endpoint,
-        where a gas sponsor calls batchedDepositWithPermit on the HL Bridge2.
+        Compass does NOT broadcast the bridge tx — the integrator's own sponsor
+        wallet calls batchedDepositWithPermit on the HL Bridge2 contract on
+        Arbitrum after the user signs. See api_docs/v2/Products/Global-Markets.mdx
+        \"Deposit USDC\" section for the bridge-broadcast code.
 
         :param owner: The user's EOA address on Arbitrum
         :param amount: USDC amount to deposit (human-readable, e.g. '1000.0')
@@ -954,8 +956,10 @@ class GlobalMarketsPerps(BaseSDK):
         Prepare a USDC deposit from Arbitrum via EIP-2612 Permit.
 
         Returns EIP-712 typed data for the user to sign off-chain (no gas needed).
-        After signing, send the permit signature to the deposit/execute endpoint,
-        where a gas sponsor calls batchedDepositWithPermit on the HL Bridge2.
+        Compass does NOT broadcast the bridge tx — the integrator's own sponsor
+        wallet calls batchedDepositWithPermit on the HL Bridge2 contract on
+        Arbitrum after the user signs. See api_docs/v2/Products/Global-Markets.mdx
+        \"Deposit USDC\" section for the bridge-broadcast code.
 
         :param owner: The user's EOA address on Arbitrum
         :param amount: USDC amount to deposit (human-readable, e.g. '1000.0')
@@ -1039,6 +1043,234 @@ class GlobalMarketsPerps(BaseSDK):
 
         raise errors.APIError("Unexpected response received", http_res)
 
+    def global_markets_perps_deposit_sponsor_prepare(
+        self,
+        *,
+        owner: str,
+        amount_raw: int,
+        deadline: int,
+        signature: str,
+        sender: str,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GlobalMarketsPerpsDepositSponsorPrepareResponse:
+        r"""Build the Bridge2 deposit tx from a signed permit
+
+        Build the Arbitrum tx that completes a USDC deposit to HL.
+
+        Takes the EIP-2612 permit signature returned by /deposit and returns
+        a fully-encoded `Bridge2.batchedDepositWithPermit` call. The integrator's
+        sponsor wallet (`sender`) broadcasts the returned tx — Compass does not
+        broadcast and does not hold gas keys.
+
+        :param owner: The user's EOA address on Arbitrum (the permit signer).
+        :param amount_raw: USDC amount in raw 6-decimal units, as returned by /deposit.
+        :param deadline: Permit deadline (unix seconds), as returned in the permit.message from /deposit.
+        :param signature: The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw).
+        :param sender: Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce).
+        :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.GlobalMarketsPerpsDepositSponsorPrepareRequest(
+            owner=owner,
+            amount_raw=amount_raw,
+            deadline=deadline,
+            signature=signature,
+            sender=sender,
+        )
+
+        req = self._build_request(
+            method="POST",
+            path="/v2/global_markets_perps/deposit/sponsor_prepare",
+            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.GlobalMarketsPerpsDepositSponsorPrepareRequest,
+            ),
+            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_global_markets_perps_deposit_sponsor_prepare",
+                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.GlobalMarketsPerpsDepositSponsorPrepareResponse, 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 global_markets_perps_deposit_sponsor_prepare_async(
+        self,
+        *,
+        owner: str,
+        amount_raw: int,
+        deadline: int,
+        signature: str,
+        sender: str,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.GlobalMarketsPerpsDepositSponsorPrepareResponse:
+        r"""Build the Bridge2 deposit tx from a signed permit
+
+        Build the Arbitrum tx that completes a USDC deposit to HL.
+
+        Takes the EIP-2612 permit signature returned by /deposit and returns
+        a fully-encoded `Bridge2.batchedDepositWithPermit` call. The integrator's
+        sponsor wallet (`sender`) broadcasts the returned tx — Compass does not
+        broadcast and does not hold gas keys.
+
+        :param owner: The user's EOA address on Arbitrum (the permit signer).
+        :param amount_raw: USDC amount in raw 6-decimal units, as returned by /deposit.
+        :param deadline: Permit deadline (unix seconds), as returned in the permit.message from /deposit.
+        :param signature: The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw).
+        :param sender: Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce).
+        :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.GlobalMarketsPerpsDepositSponsorPrepareRequest(
+            owner=owner,
+            amount_raw=amount_raw,
+            deadline=deadline,
+            signature=signature,
+            sender=sender,
+        )
+
+        req = self._build_request_async(
+            method="POST",
+            path="/v2/global_markets_perps/deposit/sponsor_prepare",
+            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.GlobalMarketsPerpsDepositSponsorPrepareRequest,
+            ),
+            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_global_markets_perps_deposit_sponsor_prepare",
+                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.GlobalMarketsPerpsDepositSponsorPrepareResponse, 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 global_markets_perps_withdraw(
         self,
         *,

{compass_api_sdk-2.2.55 → compass_api_sdk-2.2.56rc1}/src/compass_api_sdk/models/__init__.py

@@ -693,6 +693,14 @@ if TYPE_CHECKING:
         GlobalMarketsPerpsDepositResponse,
         GlobalMarketsPerpsDepositResponseTypedDict,
     )
+    from .globalmarketsperpsdepositsponsorpreparerequest import (
+        GlobalMarketsPerpsDepositSponsorPrepareRequest,
+        GlobalMarketsPerpsDepositSponsorPrepareRequestTypedDict,
+    )
+    from .globalmarketsperpsdepositsponsorprepareresponse import (
+        GlobalMarketsPerpsDepositSponsorPrepareResponse,
+        GlobalMarketsPerpsDepositSponsorPrepareResponseTypedDict,
+    )
     from .globalmarketsperpsenableunifiedaccountrequest import (
         GlobalMarketsPerpsEnableUnifiedAccountRequest,
         GlobalMarketsPerpsEnableUnifiedAccountRequestTypedDict,
@@ -2197,6 +2205,10 @@ __all__ = [
     "GlobalMarketsPerpsDepositRequestTypedDict",
     "GlobalMarketsPerpsDepositResponse",
     "GlobalMarketsPerpsDepositResponseTypedDict",
+    "GlobalMarketsPerpsDepositSponsorPrepareRequest",
+    "GlobalMarketsPerpsDepositSponsorPrepareRequestTypedDict",
+    "GlobalMarketsPerpsDepositSponsorPrepareResponse",
+    "GlobalMarketsPerpsDepositSponsorPrepareResponseTypedDict",
     "GlobalMarketsPerpsEnableUnifiedAccountRequest",
     "GlobalMarketsPerpsEnableUnifiedAccountRequestTypedDict",
     "GlobalMarketsPerpsEnableUnifiedAccountResponse",
@@ -3430,6 +3442,10 @@ _dynamic_imports: dict[str, str] = {
     "GlobalMarketsPerpsDepositRequestTypedDict": ".globalmarketsperpsdepositrequest",
     "GlobalMarketsPerpsDepositResponse": ".globalmarketsperpsdepositresponse",
     "GlobalMarketsPerpsDepositResponseTypedDict": ".globalmarketsperpsdepositresponse",
+    "GlobalMarketsPerpsDepositSponsorPrepareRequest": ".globalmarketsperpsdepositsponsorpreparerequest",
+    "GlobalMarketsPerpsDepositSponsorPrepareRequestTypedDict": ".globalmarketsperpsdepositsponsorpreparerequest",
+    "GlobalMarketsPerpsDepositSponsorPrepareResponse": ".globalmarketsperpsdepositsponsorprepareresponse",
+    "GlobalMarketsPerpsDepositSponsorPrepareResponseTypedDict": ".globalmarketsperpsdepositsponsorprepareresponse",
     "GlobalMarketsPerpsEnableUnifiedAccountRequest": ".globalmarketsperpsenableunifiedaccountrequest",
     "GlobalMarketsPerpsEnableUnifiedAccountRequestTypedDict": ".globalmarketsperpsenableunifiedaccountrequest",
     "GlobalMarketsPerpsEnableUnifiedAccountResponse": ".globalmarketsperpsenableunifiedaccountresponse",

compass_api_sdk-2.2.56rc1/src/compass_api_sdk/models/globalmarketsperpsdepositresponse.py

@@ -0,0 +1,43 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .permittypeddataresponse_output import (
+    PermitTypedDataResponseOutput,
+    PermitTypedDataResponseOutputTypedDict,
+)
+from compass_api_sdk.types import BaseModel
+from typing_extensions import TypedDict
+
+
+class GlobalMarketsPerpsDepositResponseTypedDict(TypedDict):
+    r"""EIP-2612 permit data the user signs to authorize a USDC bridge deposit.
+
+    After signing, submit the signature to /v2/global_markets_perps/deposit/sponsor_prepare
+    to get a ready-to-broadcast Arbitrum tx that calls Bridge2.batchedDepositWithPermit.
+    The integrator's sponsor wallet broadcasts that tx — Compass does not broadcast.
+    """
+
+    permit: PermitTypedDataResponseOutputTypedDict
+    r"""Response containing EIP-712 typed data for ERC-20 Permit signing."""
+    amount_raw: int
+    r"""USDC amount in raw 6-decimal units. Pass this and the signature to /deposit/sponsor_prepare."""
+    destination: str
+    r"""Address that will be credited on Hyperliquid (equals the deposit owner EOA — HL keys accounts by EVM address)."""
+
+
+class GlobalMarketsPerpsDepositResponse(BaseModel):
+    r"""EIP-2612 permit data the user signs to authorize a USDC bridge deposit.
+
+    After signing, submit the signature to /v2/global_markets_perps/deposit/sponsor_prepare
+    to get a ready-to-broadcast Arbitrum tx that calls Bridge2.batchedDepositWithPermit.
+    The integrator's sponsor wallet broadcasts that tx — Compass does not broadcast.
+    """
+
+    permit: PermitTypedDataResponseOutput
+    r"""Response containing EIP-712 typed data for ERC-20 Permit signing."""
+
+    amount_raw: int
+    r"""USDC amount in raw 6-decimal units. Pass this and the signature to /deposit/sponsor_prepare."""
+
+    destination: str
+    r"""Address that will be credited on Hyperliquid (equals the deposit owner EOA — HL keys accounts by EVM address)."""

compass_api_sdk-2.2.56rc1/src/compass_api_sdk/models/globalmarketsperpsdepositsponsorpreparerequest.py

@@ -0,0 +1,49 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from compass_api_sdk.types import BaseModel
+from typing_extensions import TypedDict
+
+
+class GlobalMarketsPerpsDepositSponsorPrepareRequestTypedDict(TypedDict):
+    r"""Take a user's signed EIP-2612 USDC permit and build an Arbitrum tx
+    that calls Bridge2.batchedDepositWithPermit.
+
+    The customer broadcasts the returned tx from their own sponsor wallet —
+    Compass does not hold gas keys (non-custodial).
+    """
+
+    owner: str
+    r"""The user's EOA address on Arbitrum (the permit signer)."""
+    amount_raw: int
+    r"""USDC amount in raw 6-decimal units, as returned by /deposit."""
+    deadline: int
+    r"""Permit deadline (unix seconds), as returned in the permit.message from /deposit."""
+    signature: str
+    r"""The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw)."""
+    sender: str
+    r"""Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce)."""
+
+
+class GlobalMarketsPerpsDepositSponsorPrepareRequest(BaseModel):
+    r"""Take a user's signed EIP-2612 USDC permit and build an Arbitrum tx
+    that calls Bridge2.batchedDepositWithPermit.
+
+    The customer broadcasts the returned tx from their own sponsor wallet —
+    Compass does not hold gas keys (non-custodial).
+    """
+
+    owner: str
+    r"""The user's EOA address on Arbitrum (the permit signer)."""
+
+    amount_raw: int
+    r"""USDC amount in raw 6-decimal units, as returned by /deposit."""
+
+    deadline: int
+    r"""Permit deadline (unix seconds), as returned in the permit.message from /deposit."""
+
+    signature: str
+    r"""The user's EIP-2612 permit signature (65-byte hex, 0x-prefixed or raw)."""
+
+    sender: str
+    r"""Sponsor wallet address that will broadcast the returned tx (used for `from` and nonce)."""

compass_api_sdk-2.2.56rc1/src/compass_api_sdk/models/globalmarketsperpsdepositsponsorprepareresponse.py

@@ -0,0 +1,28 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from .unsignedtransaction import UnsignedTransaction, UnsignedTransactionTypedDict
+from compass_api_sdk.types import BaseModel
+from typing_extensions import TypedDict
+
+
+class GlobalMarketsPerpsDepositSponsorPrepareResponseTypedDict(TypedDict):
+    r"""Fully-encoded Arbitrum tx that completes a HL Bridge2 deposit.
+
+    Broadcast `transaction` from the `sender` wallet supplied in the request.
+    After the receipt confirms, verify a USDC `Transfer` event was emitted —
+    Bridge2 can silently no-op without reverting.
+    """
+
+    transaction: UnsignedTransactionTypedDict
+
+
+class GlobalMarketsPerpsDepositSponsorPrepareResponse(BaseModel):
+    r"""Fully-encoded Arbitrum tx that completes a HL Bridge2 deposit.
+
+    Broadcast `transaction` from the `sender` wallet supplied in the request.
+    After the receipt confirms, verify a USDC `Transfer` event was emitted —
+    Bridge2 can silently no-op without reverting.
+    """
+
+    transaction: UnsignedTransaction

compass_api_sdk-2.2.55/src/compass_api_sdk/models/globalmarketsperpsdepositresponse.py

@@ -1,41 +0,0 @@
-"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
-
-from __future__ import annotations
-from .permittypeddataresponse_output import (
-    PermitTypedDataResponseOutput,
-    PermitTypedDataResponseOutputTypedDict,
-)
-from compass_api_sdk.types import BaseModel
-from typing_extensions import TypedDict
-
-
-class GlobalMarketsPerpsDepositResponseTypedDict(TypedDict):
-    r"""EIP-2612 permit data for the user to sign, plus deposit metadata.
-
-    After the user signs the permit, the gas sponsor calls
-    batchedDepositWithPermit on the Hyperliquid Bridge2 contract.
-    """
-
-    permit: PermitTypedDataResponseOutputTypedDict
-    r"""Response containing EIP-712 typed data for ERC-20 Permit signing."""
-    amount_raw: int
-    r"""USDC amount in raw units (6 decimals)"""
-    destination: str
-    r"""Global Markets Perps Safe address on HyperEVM that receives the deposit on HyperCore"""
-
-
-class GlobalMarketsPerpsDepositResponse(BaseModel):
-    r"""EIP-2612 permit data for the user to sign, plus deposit metadata.
-
-    After the user signs the permit, the gas sponsor calls
-    batchedDepositWithPermit on the Hyperliquid Bridge2 contract.
-    """
-
-    permit: PermitTypedDataResponseOutput
-    r"""Response containing EIP-712 typed data for ERC-20 Permit signing."""
-
-    amount_raw: int
-    r"""USDC amount in raw units (6 decimals)"""
-
-    destination: str
-    r"""Global Markets Perps Safe address on HyperEVM that receives the deposit on HyperCore"""