fix: resolve mypy type errors

Author: StableOps

pyproject.toml

@@ -58,7 +58,7 @@ asyncio_mode = "auto"
 addopts = "--cov=stableops --cov-report=term-missing --cov-report=html"
 
 [tool.mypy]
-python_version = "3.8"
+python_version = "3.10"
 strict = true
 warn_return_any = true
 warn_unused_configs = true

stableops/client.py

@@ -1,6 +1,6 @@
 """StableOps client."""
 
-from typing import Optional
+from typing import Any, Optional
 
 from stableops.addresses import AddressesApi, AsyncAddressesApi
 from stableops.checkout_sessions import AsyncCheckoutSessionsApi, CheckoutSessionsApi
@@ -68,7 +68,7 @@ def __enter__(self) -> "StableOps":
         """Context manager entry."""
         return self
 
-    def __exit__(self, *args) -> None:
+    def __exit__(self, *args: Any) -> None:
         """Context manager exit."""
         self.close()
 
@@ -132,6 +132,6 @@ async def __aenter__(self) -> "AsyncStableOps":
         """Async context manager entry."""
         return self
 
-    async def __aexit__(self, *args) -> None:
+    async def __aexit__(self, *args: Any) -> None:
         """Async context manager exit."""
         await self.close()

stableops/http.py

@@ -304,7 +304,7 @@ def request(
     def _parse_error(self, response: httpx.Response) -> Dict[str, Any]:
         """Parse error response."""
         try:
-            return response.json()
+            return response.json()  # type: ignore[no-any-return]
         except Exception:
             return {"message": response.text or "Unknown error", "code": "unknown_error"}
 
@@ -501,7 +501,7 @@ async def request(
     def _parse_error(self, response: httpx.Response) -> Dict[str, Any]:
         """Parse error response."""
         try:
-            return response.json()
+            return response.json()  # type: ignore[no-any-return]
         except Exception:
             return {"message": response.text or "Unknown error", "code": "unknown_error"}
 

tests/test_types.py

@@ -2,10 +2,16 @@
 
 from typing import get_args
 
-from stableops.types import ChainId, PaymentOrder, PaymentOrderStatus
+from stableops.types import (
+    AcceptedAssetInput,
+    ChainId,
+    PaymentOrder,
+    PaymentOrderInstruction,
+    PaymentOrderStatus,
+)
 
 
-def test_type_aliases_match_current_api_contract():
+def test_type_aliases_match_current_api_contract() -> None:
     """Public Literal aliases should expose the same enum values as the API."""
     assert "solana" in get_args(ChainId)
     assert "optimism" in get_args(ChainId)
@@ -15,7 +21,7 @@ def test_type_aliases_match_current_api_contract():
     assert "CREATED" not in get_args(PaymentOrderStatus)
 
 
-def test_payment_order_accepts_current_api_wire_values():
+def test_payment_order_accepts_current_api_wire_values() -> None:
     """Python SDK types should match values returned by the API."""
     order = PaymentOrder(
         id="po_123",
@@ -26,13 +32,9 @@ def test_payment_order_accepts_current_api_wire_values():
         expires_at=None,
         metadata=None,
         created_at="2026-05-31T00:00:00.000Z",
-        accepted_assets=[{"chain": "solana", "asset": "USDC"}],
+        accepted_assets=[AcceptedAssetInput(chain="solana", asset="USDC")],
         payment_instructions=[
-            {
-                "chain": "solana",
-                "asset": "USDC",
-                "address": "RecipientWallet123",
-            }
+            PaymentOrderInstruction(chain="solana", asset="USDC", address="RecipientWallet123")
         ],
     )
 

tests/test_webhooks.py

@@ -2,6 +2,7 @@
 
 import hashlib
 import hmac
+from typing import Any
 
 from stableops.webhooks import (
     SIGNATURE_HEADER,
@@ -24,11 +25,11 @@ def build_header(secret: str, timestamp: int, body: str) -> str:
     return f"t={timestamp},v1={signature}"
 
 
-def test_signature_header_constant_matches_delivery_protocol():
+def test_signature_header_constant_matches_delivery_protocol() -> None:
     assert SIGNATURE_HEADER == "x-product-signature"
 
 
-def test_valid_signature_header():
+def test_valid_signature_header() -> None:
     secret = "whsec_test123"
     body = '{"type":"payment.finalized","data":{"payment_order_id":"po_123"}}'
 
@@ -43,7 +44,7 @@ def test_valid_signature_header():
     assert result.reason == "valid"
 
 
-def test_accepts_any_v1_signature_during_rotation():
+def test_accepts_any_v1_signature_during_rotation() -> None:
     old_secret = "whsec_old"
     new_secret = "whsec_new"
     body = '{"type":"payment.finalized"}'
@@ -63,7 +64,7 @@ def test_accepts_any_v1_signature_during_rotation():
     assert result.reason == "valid"
 
 
-def test_invalid_signature():
+def test_invalid_signature() -> None:
     result = verify_webhook_signature(
         body='{"type":"payment.finalized"}',
         header=f"t={NOW},v1=invalid_signature",
@@ -75,7 +76,7 @@ def test_invalid_signature():
     assert result.reason == "invalid_signature"
 
 
-def test_missing_header():
+def test_missing_header() -> None:
     result = verify_webhook_signature(
         body='{"type":"payment.finalized"}',
         header="",
@@ -87,7 +88,7 @@ def test_missing_header():
     assert result.reason == "missing_header"
 
 
-def test_timestamp_too_old():
+def test_timestamp_too_old() -> None:
     result = verify_webhook_signature(
         body='{"type":"payment.finalized"}',
         header=f"t={NOW},v1=sig123",
@@ -100,7 +101,7 @@ def test_timestamp_too_old():
     assert result.reason == "timestamp_expired"
 
 
-def test_invalid_header_format():
+def test_invalid_header_format() -> None:
     result = verify_webhook_signature(
         body='{"type":"payment.finalized"}',
         header="t=not_a_number,v1=sig123",
@@ -112,30 +113,30 @@ def test_invalid_header_format():
     assert result.reason == "invalid_format"
 
 
-def test_webhooks_api_matches_server_routes():
+def test_webhooks_api_matches_server_routes() -> None:
     assert not hasattr(WebhooksApi, "retrieve")
     assert not hasattr(WebhooksApi, "delete")
     assert not hasattr(AsyncWebhooksApi, "retrieve")
     assert not hasattr(AsyncWebhooksApi, "delete")
 
 
-def test_webhooks_api_exposes_delivery_and_replay_methods():
+def test_webhooks_api_exposes_delivery_and_replay_methods() -> None:
     for name in ("replay", "list_deliveries", "replay_delivery", "replay_dead_letters"):
         assert hasattr(WebhooksApi, name)
         assert hasattr(AsyncWebhooksApi, name)
 
 
 class _FakeHttp:
-    def __init__(self, response):
+    def __init__(self, response: Any) -> None:
         self.response = response
-        self.last_request = {}
+        self.last_request: dict[str, Any] = {}
 
-    def request(self, **kwargs):
+    def request(self, **kwargs: Any) -> Any:
         self.last_request = kwargs
         return self.response
 
 
-def test_create_endpoint_forwards_redact_metadata():
+def test_create_endpoint_forwards_redact_metadata() -> None:
     http = _FakeHttp(
         {
             "id": "we_1",
@@ -159,7 +160,7 @@ def test_create_endpoint_forwards_redact_metadata():
     assert endpoint.redact_metadata is True
 
 
-def test_list_deliveries_filters_and_parses():
+def test_list_deliveries_filters_and_parses() -> None:
     http = _FakeHttp(
         {
             "items": [
@@ -198,7 +199,7 @@ def test_list_deliveries_filters_and_parses():
     assert deliveries[0].payload == {"type": "payment.finalized"}
 
 
-def test_replay_dead_letters_parses_result():
+def test_replay_dead_letters_parses_result() -> None:
     http = _FakeHttp(
         {
             "replayed": 2,