silhouette-python-sdk 0.2.0__tar.gz → 0.3.0__tar.gz

{silhouette_python_sdk-0.2.0 → silhouette_python_sdk-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: silhouette-python-sdk
-Version: 0.2.0
+Version: 0.3.0
 Summary: Python SDK for trading on Silhouette - the shield exchange on Hyperliquid
 License: MIT
 Keywords: silhouette,trading,privacy,exchange,hyperliquid,defi,crypto,sdk
@@ -17,15 +17,15 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: attrs (>=22.2)
 Requires-Dist: cryptography (>=46,<47)
 Requires-Dist: httpx (>=0.23,<0.29)
 Requires-Dist: hyperliquid-python-sdk (>=0.21,<1)
+Requires-Dist: pydantic (>=2.0,<3)
 Requires-Dist: pyjwt (>=2.10,<3)
-Requires-Dist: python-dateutil (>=2.8,<3)
 Requires-Dist: requests (>=2.32,<3)
 Requires-Dist: siwe (>=4.4,<5)
 Requires-Dist: typing_extensions (>=4.9) ; python_version < "3.11"
+Requires-Dist: websockets (>=15,<16)
 Project-URL: Homepage, https://github.com/silhouette-exchange/silhouette-python-sdk
 Project-URL: Repository, https://github.com/silhouette-exchange/silhouette-python-sdk
 Description-Content-Type: text/markdown
@@ -105,9 +105,9 @@ print(f"Balances: {balances_response['balances']}")
 # Place an order (returns dict, no need to import models)
 order = client.order.create_order(
     side="buy",
-    orderType="limit",
-    baseToken="HYPE",
-    quoteToken="USDC",
+    order_type="limit",
+    base_token="HYPE",
+    quote_token="USDC",
     amount="1.0",
     price="0.001",
 )
@@ -129,7 +129,7 @@ The enhanced Hyperliquid SDK includes these convenience methods:
 - `await_withdrawal_completion(wallet_address: str, pre_withdrawal_balance: float, token_symbol: str, timeout: int) -> bool` - Poll balance until withdrawal completes
 
 **Exchange class:**
-- `deposit_to_silhouette(contract_address: str, token_symbol: str, amount: str, converter: TokenConverter) -> dict` - Deposit tokens from Hyperliquid to Silhouette contract
+- `deposit_to_silhouette(silhouette_address: str, token_symbol: str, amount: str, converter: TokenConverter) -> dict` - Deposit tokens from Hyperliquid to Silhouette contract
 
 All other Hyperliquid SDK methods work exactly as documented in the [official Hyperliquid SDK](https://github.com/hyperliquid-dex/hyperliquid-python-sdk).
 
@@ -141,6 +141,7 @@ The `SilhouetteApiClient` provides access to the Silhouette shielded exchange:
 - **No model imports needed**: Pydantic models are used internally for validation, but you work with simple dicts
 - **User operations**: Balances, withdrawal initiation
 - **Order management**: Create, cancel, query orders
+- **Delegated orders**: List, get, and batch retrieve delegated orders
 - **Trade execution**: Privacy-preserving order execution
 - **Automatic authentication**: SIWE-based session management with automatic token refresh
 
@@ -154,6 +155,29 @@ response = client.user.get_balances()
 # }
 ```
 
+### Delegated orders
+
+Delegated orders are orders placed on Hyperliquid by Silhouette on behalf of a trader. Query them using the `delegated_order` operations:
+
+```python
+# List delegated orders with optional filters
+orders = client.delegated_order.list_delegated_orders(
+    status="open",
+    limit=50,
+)
+print(f"Found {len(orders['orders'])} orders")
+
+# Get a single order by ID
+order = client.delegated_order.get_delegated_order("order-id-here")
+print(f"Order status: {order['order']['status']}")
+
+# Batch retrieve multiple orders
+batch = client.delegated_order.batch_get_delegated_orders(
+    ["order-1", "order-2", "order-3"]
+)
+print(f"Found: {len(batch['orders'])}, Not found: {batch['notFound']}")
+```
+
 ## API Design
 
 ### Why Dicts Instead of Models?
@@ -173,21 +197,24 @@ The SDK uses a hybrid approach for optimal developer experience:
 
 ### Regenerating models
 
-Models are generated from the OpenAPI specification. When the Silhouette API changes, regenerate the models to stay in sync:
+Models are generated from the OpenAPI specifications using `datamodel-code-generator`. When the Silhouette API changes, regenerate the models to stay in sync:
 
 ```bash
-# Fetch spec from local Heimdall and regenerate models
-./scripts/regenerate-models.sh
+# Generate from committed specs
+make generate
 
-# Or specify a custom URL
-./scripts/regenerate-models.sh https://api.silhouette.exchange
+# Or fetch fresh specs and regenerate in one step
+make regenerate
 
-# Then run tests to catch any breaking changes
+# Fetch from a specific URL
+make fetch-heimdall-v0-spec URL=https://api-staging.silhouette.exchange
+make fetch-heimdall-v1-spec URL=https://api-staging.silhouette.exchange
+make generate
+
+# Run tests to catch any breaking changes
 make test
 ```
 
-Requires `curl`, `jq`, and `openapi-generator-cli` to be installed.
-
 ## Configuration
 
 Create `examples/config.json` from the example template:

{silhouette_python_sdk-0.2.0 → silhouette_python_sdk-0.3.0}/README.md

@@ -73,9 +73,9 @@ print(f"Balances: {balances_response['balances']}")
 # Place an order (returns dict, no need to import models)
 order = client.order.create_order(
     side="buy",
-    orderType="limit",
-    baseToken="HYPE",
-    quoteToken="USDC",
+    order_type="limit",
+    base_token="HYPE",
+    quote_token="USDC",
     amount="1.0",
     price="0.001",
 )
@@ -97,7 +97,7 @@ The enhanced Hyperliquid SDK includes these convenience methods:
 - `await_withdrawal_completion(wallet_address: str, pre_withdrawal_balance: float, token_symbol: str, timeout: int) -> bool` - Poll balance until withdrawal completes
 
 **Exchange class:**
-- `deposit_to_silhouette(contract_address: str, token_symbol: str, amount: str, converter: TokenConverter) -> dict` - Deposit tokens from Hyperliquid to Silhouette contract
+- `deposit_to_silhouette(silhouette_address: str, token_symbol: str, amount: str, converter: TokenConverter) -> dict` - Deposit tokens from Hyperliquid to Silhouette contract
 
 All other Hyperliquid SDK methods work exactly as documented in the [official Hyperliquid SDK](https://github.com/hyperliquid-dex/hyperliquid-python-sdk).
 
@@ -109,6 +109,7 @@ The `SilhouetteApiClient` provides access to the Silhouette shielded exchange:
 - **No model imports needed**: Pydantic models are used internally for validation, but you work with simple dicts
 - **User operations**: Balances, withdrawal initiation
 - **Order management**: Create, cancel, query orders
+- **Delegated orders**: List, get, and batch retrieve delegated orders
 - **Trade execution**: Privacy-preserving order execution
 - **Automatic authentication**: SIWE-based session management with automatic token refresh
 
@@ -122,6 +123,29 @@ response = client.user.get_balances()
 # }
 ```
 
+### Delegated orders
+
+Delegated orders are orders placed on Hyperliquid by Silhouette on behalf of a trader. Query them using the `delegated_order` operations:
+
+```python
+# List delegated orders with optional filters
+orders = client.delegated_order.list_delegated_orders(
+    status="open",
+    limit=50,
+)
+print(f"Found {len(orders['orders'])} orders")
+
+# Get a single order by ID
+order = client.delegated_order.get_delegated_order("order-id-here")
+print(f"Order status: {order['order']['status']}")
+
+# Batch retrieve multiple orders
+batch = client.delegated_order.batch_get_delegated_orders(
+    ["order-1", "order-2", "order-3"]
+)
+print(f"Found: {len(batch['orders'])}, Not found: {batch['notFound']}")
+```
+
 ## API Design
 
 ### Why Dicts Instead of Models?
@@ -141,21 +165,24 @@ The SDK uses a hybrid approach for optimal developer experience:
 
 ### Regenerating models
 
-Models are generated from the OpenAPI specification. When the Silhouette API changes, regenerate the models to stay in sync:
+Models are generated from the OpenAPI specifications using `datamodel-code-generator`. When the Silhouette API changes, regenerate the models to stay in sync:
 
 ```bash
-# Fetch spec from local Heimdall and regenerate models
-./scripts/regenerate-models.sh
+# Generate from committed specs
+make generate
 
-# Or specify a custom URL
-./scripts/regenerate-models.sh https://api.silhouette.exchange
+# Or fetch fresh specs and regenerate in one step
+make regenerate
 
-# Then run tests to catch any breaking changes
+# Fetch from a specific URL
+make fetch-heimdall-v0-spec URL=https://api-staging.silhouette.exchange
+make fetch-heimdall-v1-spec URL=https://api-staging.silhouette.exchange
+make generate
+
+# Run tests to catch any breaking changes
 make test
 ```
 
-Requires `curl`, `jq`, and `openapi-generator-cli` to be installed.
-
 ## Configuration
 
 Create `examples/config.json` from the example template:

{silhouette_python_sdk-0.2.0 → silhouette_python_sdk-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "silhouette-python-sdk"
-version = "0.2.0"
+version = "0.3.0"
 description = "Python SDK for trading on Silhouette - the shield exchange on Hyperliquid"
 readme = "README.md"
 license = "MIT"
@@ -31,8 +31,8 @@ dependencies = [
   "pyjwt>=2.10,<3",
   "cryptography>=46,<47",
   "httpx>=0.23,<0.29",
-  "attrs>=22.2",
-  "python-dateutil>=2.8,<3",
+  "websockets>=15,<16",
+  "pydantic>=2.0,<3",
 ]
 
 [project.urls]
@@ -42,9 +42,13 @@ Repository = "https://github.com/silhouette-exchange/silhouette-python-sdk"
 [tool.poetry]
 packages = [
   { include = "silhouette" },
-  { include = "generated" },
 ]
-include = ["silhouette/py.typed"]
+include = [
+  "silhouette/py.typed",
+  { path = "silhouette/api/generated/__init__.py", format = ["sdist", "wheel"] },
+  { path = "silhouette/api/v1/generated/__init__.py", format = ["sdist", "wheel"] },
+  { path = "silhouette/twap/generated/__init__.py", format = ["sdist", "wheel"] },
+]
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.4"
@@ -54,15 +58,14 @@ pre-commit = "^4.3"
 safety = "^3.6"
 coverage = "^7.10"
 pytest-cov = "^7"
-pytest-socket = "^0.7"
+pytest-socket = "^0.7.0"
 types-requests = "^2.31"
-types-python-dateutil = "^2.8"
-openapi-python-client = "^0.26"
+datamodel-code-generator = {version = "^0.29", extras = ["http"]}
 
 [tool.ruff]
 target-version = "py310"
 line-length = 120
-exclude = [".git", ".mypy_cache", ".ruff_cache", "__pycache__", "dist", "build", "silhouette/api/generated"]
+exclude = [".git", ".mypy_cache", ".ruff_cache", "__pycache__", "dist", "build", "silhouette/api/generated", "silhouette/api/v1/generated", "silhouette/twap/generated"]
 
 [tool.ruff.lint]
 select = ["E", "W", "F", "I", "B", "C4", "UP", "S"]
@@ -94,7 +97,7 @@ python_version = "3.10"
 pretty = true
 show_traceback = true
 color_output = true
-exclude = ["examples/", "silhouette/api/generated/"]
+exclude = ["examples/", "silhouette/api/generated/", "silhouette/api/v1/generated/", "silhouette/twap/generated/"]
 
 allow_redefinition = false
 check_untyped_defs = true
@@ -162,7 +165,10 @@ norecursedirs = [
   ".tox",
   ".git",
   "__pycache__",
+  "examples",
   "silhouette/api/generated",
+  "silhouette/api/v1/generated",
+  "silhouette/twap/generated",
 ]
 doctest_optionflags = [
   "NUMBER",
@@ -186,6 +192,8 @@ addopts = [
 branch = true
 omit = [
   "silhouette/api/generated/*",
+  "silhouette/api/v1/generated/*",
+  "silhouette/twap/generated/*",
 ]
 
 [tool.coverage.report]

{silhouette_python_sdk-0.2.0 → silhouette_python_sdk-0.3.0}/silhouette/api/__init__.py

@@ -1,5 +1,10 @@
 """Silhouette API client for enclave integration."""
 
 from silhouette.api.client import SilhouetteApiClient, SilhouetteApiError
+from silhouette.api.rfq_types import RfqEvent
 
-__all__ = ["SilhouetteApiClient", "SilhouetteApiError"]
+__all__ = [
+    "RfqEvent",
+    "SilhouetteApiClient",
+    "SilhouetteApiError",
+]

{silhouette_python_sdk-0.2.0 → silhouette_python_sdk-0.3.0}/silhouette/api/auth.py

@@ -40,6 +40,44 @@ class AuthConfig:
     """Chain ID for SIWE message signing (1 for mainnet, 421614 for Arbitrum Sepolia testnet)."""
 
 
+def sign_siwe_message(
+    wallet: LocalAccount,
+    base_url: str,
+    chain_id: int = 1,
+) -> tuple[str, str]:
+    """Create and sign a SIWE message for authentication.
+
+    Args:
+        wallet: The wallet to sign with
+        base_url: The API base URL (used for domain and URI)
+        chain_id: Chain ID for SIWE message (1 for mainnet)
+
+    Returns:
+        Tuple of (prepared_message_str, signature_hex)
+    """
+    from urllib.parse import urlparse
+
+    parsed = urlparse(base_url)
+    domain = parsed.netloc or "localhost"
+
+    message = SiweMessage(
+        domain=domain,
+        address=wallet.address,
+        statement="Sign in with Ethereum to the app.",
+        uri=f"{base_url}/login",
+        version="1",
+        chain_id=chain_id,
+        nonce=secrets.token_hex(12),
+        issued_at=datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
+    )
+    prepared_message_str = message.prepare_message()
+
+    message_to_sign = encode_defunct(text=prepared_message_str)
+    signed_message = wallet.sign_message(message_to_sign)
+    signature_hex = "0x" + signed_message.signature.hex()
+    return prepared_message_str, signature_hex
+
+
 class AuthManager:
     """Manages authentication state and automatic login for the API client."""
 
@@ -191,26 +229,6 @@ class AuthManager:
 
         raise RuntimeError(f"Login failed after {self.config.max_login_retries} attempts: {last_error}") from last_error
 
-    def _extract_domain_from_url(self, url: str) -> str:
-        """
-        Extract domain (host:port) from a URL for SIWE message.
-
-        Args:
-            url: Full URL like "https://api.silhouette.exchange/v0"
-
-        Returns:
-            Domain string like "api.silhouette.exchange""
-        """
-        from urllib.parse import urlparse
-
-        parsed = urlparse(url)
-        # netloc includes host and port (e.g., "localhost:8081" or "api.silhouette.exchange")
-        domain = parsed.netloc
-        if not domain:
-            # Fallback if URL parsing fails
-            domain = "localhost"
-        return domain
-
     def _perform_login(self) -> None:
         """
         Perform the SIWE login flow.
@@ -221,32 +239,12 @@ class AuthManager:
         if self._wallet is None:
             raise ValueError("No wallet configured for login")
 
-        # Extract domain from base_url for SIWE message
-        domain = self._extract_domain_from_url(self.client.base_url)
-
-        # Generate SIWE message
-        message = SiweMessage(
-            domain=domain,
-            address=self._wallet.address,
-            statement="Sign in with Ethereum to the app.",
-            uri=f"{self.client.base_url}/login",
-            version="1",
-            chain_id=self.config.chain_id,
-            nonce=secrets.token_hex(12),
-            issued_at=datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
+        message, signature = sign_siwe_message(
+            self._wallet,
+            self.client.base_url,
+            self.config.chain_id,
         )
-        prepared_message_str = message.prepare_message()
-
-        # Sign the message
-        message_to_sign = encode_defunct(text=prepared_message_str)
-        signed_message = self._wallet.sign_message(message_to_sign)
-
-        # Verify signature client-side
-        message.verify(signed_message.signature)
-
-        # Call login API
-        signature_hex = "0x" + signed_message.signature.hex()
-        token = self.client._raw_login(prepared_message_str, signature_hex)
+        token = self.client._raw_login(message, signature)
         self.set_token(token)
 
     def handle_auth_error(self, response_status: int) -> bool:

silhouette_python_sdk-0.3.0/silhouette/api/base_model.py

@@ -0,0 +1,11 @@
+"""Base model for generated Pydantic models.
+
+Configures `populate_by_name=True` so that models accept both snake_case
+field names and their camelCase aliases when constructing instances.
+"""
+
+from pydantic import BaseModel, ConfigDict
+
+
+class ApiBaseModel(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)