fere-sdk 0.6.0__tar.gz → 0.7.0.dev53__tar.gz

{fere_sdk-0.6.0 → fere_sdk-0.7.0.dev53}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: fere-sdk
-Version: 0.6.0
+Version: 0.7.0.dev53
 Summary: Python SDK for the FereAI Gateway API
 Author-email: Fere AI <hello@fereai.xyz>
 License-Expression: MIT

{fere_sdk-0.6.0 → fere_sdk-0.7.0.dev53}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fere-sdk"
-version = "0.6.0"
+version = "0.7.0.dev53"
 description = "Python SDK for the FereAI Gateway API"
 readme = "README.md"
 requires-python = ">=3.10"

{fere_sdk-0.6.0 → fere_sdk-0.7.0.dev53}/src/fere_sdk/client.py

@@ -356,15 +356,22 @@ class FereClient:
     async def perp_withdraw(
         self,
         amount_usd: float,
-        destination_chain_id: int,
+        destination_chain_id: int | None = None,
         destination_token: str | None = None,
         timeout: int = DEFAULT_TIMEOUT,
+        to_address: str | None = None,
     ) -> dict:
-        """Withdraw perp collateral and wait for completion."""
+        """Withdraw perp collateral and wait for completion.
+
+        Pass ``to_address`` to receive USDC on Arbitrum at an outside
+        address directly, or ``destination_chain_id`` (+ token) to land it
+        in the agent's own wallet on that chain.
+        """
         req = PerpWithdrawRequest(
             amount_usd=amount_usd,
             destination_chain_id=destination_chain_id,
             destination_token=destination_token,
+            to_address=to_address,
         )
         return await self._api.perp_withdraw(req, wait=True, timeout=timeout)
 

{fere_sdk-0.6.0 → fere_sdk-0.7.0.dev53}/src/fere_sdk/perp_models.py

@@ -101,15 +101,24 @@ class PerpFundRequest:
 
 @dataclass
 class PerpWithdrawRequest:
+    """Withdraw perp collateral.
+
+    Set ``destination_chain_id`` (+ token) to land it in the agent's own
+    wallet, or ``to_address`` to receive USDC on Arbitrum at an outside
+    address directly (Hyperliquid's $1 fee deducted). One is required.
+    """
+
     amount_usd: float
-    destination_chain_id: int
+    destination_chain_id: int | None = None
     destination_token: str | None = None
+    to_address: str | None = None
 
     def to_dict(self) -> dict:
-        d: dict = {
-            "amount_usd": self.amount_usd,
-            "destination_chain_id": self.destination_chain_id,
-        }
+        d: dict = {"amount_usd": self.amount_usd}
+        if self.destination_chain_id is not None:
+            d["destination_chain_id"] = self.destination_chain_id
         if self.destination_token is not None:
             d["destination_token"] = self.destination_token
+        if self.to_address is not None:
+            d["to_address"] = self.to_address
         return d