dfns-sdk 0.0.0.dev0__py3-none-any.whl

dfns_sdk/generated/signers/__init__.py

@@ -0,0 +1,7 @@
+"""Signers domain module."""
+
+from .client import SignersClient
+from .delegated_client import DelegatedSignersClient
+from . import types
+
+__all__ = ["SignersClient", "DelegatedSignersClient", "types"]

dfns_sdk/generated/signers/client.py

@@ -0,0 +1,45 @@
+"""Client for the signers domain."""
+
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from . import types as T
+
+
+class SignersClient:
+    """Client for signers operations."""
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def list_key_stores(self) -> T.ListKeyStoresResponse:
+        """
+        List Key Stores.
+
+        Returns:
+            T.ListKeyStoresResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/key-stores",
+            path_params={},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )
+
+    def list_signers(self) -> T.ListSignersResponse:
+        """
+        List Signers.
+
+        Returns:
+            T.ListSignersResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/signers",
+            path_params={},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )

dfns_sdk/generated/signers/delegated_client.py

@@ -0,0 +1,56 @@
+"""Delegated client for the signers domain."""
+
+import json
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from ...base_auth_api import (
+    BaseAuthApi,
+    SignUserActionChallengeRequest,
+    UserActionChallengeResponse,
+)
+from . import types as T
+
+
+class DelegatedSignersClient:
+    """
+    Delegated client for signers operations.
+
+    This client separates user action signing into _init() and _complete() method pairs,
+    allowing external systems to handle the signing process.
+    """
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def list_key_stores(self) -> T.ListKeyStoresResponse:
+        """
+        List Key Stores.
+
+        Returns:
+            T.ListKeyStoresResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/key-stores",
+            path_params={},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )
+
+    def list_signers(self) -> T.ListSignersResponse:
+        """
+        List Signers.
+
+        Returns:
+            T.ListSignersResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/signers",
+            path_params={},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )

dfns_sdk/generated/signers/types.py

@@ -0,0 +1,13 @@
+"""Types for the signers domain."""
+
+from typing import Any, Literal, NotRequired, Optional, TypedDict, Union
+
+class ListKeyStoresResponse(TypedDict, total=False):
+    """listKeyStores response."""
+
+    items: list[TypedDict]
+
+class ListSignersResponse(TypedDict, total=False):
+    """listSigners response."""
+
+    clusters: list[TypedDict]

dfns_sdk/generated/staking/__init__.py

@@ -0,0 +1,7 @@
+"""Staking domain module."""
+
+from .client import StakingClient
+from .delegated_client import DelegatedStakingClient
+from . import types
+
+__all__ = ["StakingClient", "DelegatedStakingClient", "types"]

dfns_sdk/generated/staking/client.py

@@ -0,0 +1,142 @@
+"""Client for the staking domain."""
+
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from . import types as T
+
+
+class StakingClient:
+    """Client for staking operations."""
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def list_stakes(self, query: Optional[T.ListStakesQuery] = None) -> T.ListStakesResponse:
+        """
+        List Stakes.
+
+        Retrieve the list of stakes.
+
+        Args:
+        query: Query parameters.
+
+        Returns:
+            T.ListStakesResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes",
+            path_params={},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_stake(self, body: T.CreateStakeRequest) -> T.CreateStakeResponse:
+        """
+        Create Stake.
+
+        Create a new stake.
+
+        Args:
+        body: Request body.
+
+        Returns:
+            T.CreateStakeResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/staking/stakes",
+            path_params={},
+            query_params=None,
+            body=body,
+            requires_signature=True,
+        )
+
+    def list_stake_actions(self, stake_id: str, query: Optional[T.ListStakeActionsQuery] = None) -> T.ListStakeActionsResponse:
+        """
+        List Stake Actions.
+
+        Retrieve the list of actions for a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.ListStakeActionsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}/actions",
+            path_params={"stakeId": stake_id},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_stake_action(self, stake_id: str, body: T.CreateStakeActionRequest) -> T.CreateStakeActionResponse:
+        """
+        Create Stake Action.
+
+        Create a new action for an existing stake.
+
+        Args:
+        stake_id: Path parameter.
+        body: Request body.
+
+        Returns:
+            T.CreateStakeActionResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/staking/stakes/{stakeId}/actions",
+            path_params={"stakeId": stake_id},
+            query_params=None,
+            body=body,
+            requires_signature=True,
+        )
+
+    def get_stakes(self, stake_id: str, query: Optional[T.GetStakesQuery] = None) -> T.GetStakesResponse:
+        """
+        Get Stakes.
+
+        Retrieve the details of a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.GetStakesResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}",
+            path_params={"stakeId": stake_id},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def get_stake_rewards(self, stake_id: str) -> T.GetStakeRewardsResponse:
+        """
+        Get Stake Rewards.
+
+        Retrieves the rewards linked to a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+
+        Returns:
+            T.GetStakeRewardsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}/rewards",
+            path_params={"stakeId": stake_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )

dfns_sdk/generated/staking/delegated_client.py

@@ -0,0 +1,211 @@
+"""Delegated client for the staking domain."""
+
+import json
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from ...base_auth_api import (
+    BaseAuthApi,
+    SignUserActionChallengeRequest,
+    UserActionChallengeResponse,
+)
+from . import types as T
+
+
+class DelegatedStakingClient:
+    """
+    Delegated client for staking operations.
+
+    This client separates user action signing into _init() and _complete() method pairs,
+    allowing external systems to handle the signing process.
+    """
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def list_stakes(self, query: Optional[T.ListStakesQuery] = None) -> T.ListStakesResponse:
+        """
+        List Stakes.
+
+        Retrieve the list of stakes.
+
+        Args:
+        query: Query parameters.
+
+        Returns:
+            T.ListStakesResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes",
+            path_params={},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_stake_init(self, body: T.CreateStakeRequest) -> UserActionChallengeResponse:
+        """
+        Initialize Create Stake.
+
+        Creates a user action challenge for external signing.
+
+        Args:
+        body: Request body.
+
+        Returns:
+            UserActionChallengeResponse: The challenge to sign externally.
+        """
+        path = "/staking/stakes"
+        payload = json.dumps(body, separators=(",", ":")) if body else ""
+
+        return BaseAuthApi.create_user_action_challenge(
+            self._http,
+            user_action_http_method="POST",
+            user_action_http_path=path,
+            user_action_payload=payload,
+        )
+
+    def create_stake_complete(self, body: T.CreateStakeRequest, signed_challenge: SignUserActionChallengeRequest) -> T.CreateStakeResponse:
+        """
+        Complete Create Stake.
+
+        Submits the signed challenge and makes the API request.
+
+        Args:
+        body: Request body.
+        signed_challenge: The signed challenge from external signing.
+
+        Returns:
+            T.CreateStakeResponse: The API response.
+        """
+        user_action_result = BaseAuthApi.sign_user_action_challenge(
+            self._http, signed_challenge
+        )
+        user_action_token = user_action_result["userAction"]
+
+        return self._http.request_with_user_action(
+            method="POST",
+            path="/staking/stakes",
+            path_params={},
+            query_params=None,
+            body=body,
+            user_action=user_action_token,
+        )
+
+    def list_stake_actions(self, stake_id: str, query: Optional[T.ListStakeActionsQuery] = None) -> T.ListStakeActionsResponse:
+        """
+        List Stake Actions.
+
+        Retrieve the list of actions for a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.ListStakeActionsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}/actions",
+            path_params={"stakeId": stake_id},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_stake_action_init(self, stake_id: str, body: T.CreateStakeActionRequest) -> UserActionChallengeResponse:
+        """
+        Initialize Create Stake Action.
+
+        Creates a user action challenge for external signing.
+
+        Args:
+        stake_id: Path parameter.
+        body: Request body.
+
+        Returns:
+            UserActionChallengeResponse: The challenge to sign externally.
+        """
+        path = "/staking/stakes/{stakeId}/actions"
+        path = path.replace("{stakeId}", str(stake_id))
+        payload = json.dumps(body, separators=(",", ":")) if body else ""
+
+        return BaseAuthApi.create_user_action_challenge(
+            self._http,
+            user_action_http_method="POST",
+            user_action_http_path=path,
+            user_action_payload=payload,
+        )
+
+    def create_stake_action_complete(self, stake_id: str, body: T.CreateStakeActionRequest, signed_challenge: SignUserActionChallengeRequest) -> T.CreateStakeActionResponse:
+        """
+        Complete Create Stake Action.
+
+        Submits the signed challenge and makes the API request.
+
+        Args:
+        stake_id: Path parameter.
+        body: Request body.
+        signed_challenge: The signed challenge from external signing.
+
+        Returns:
+            T.CreateStakeActionResponse: The API response.
+        """
+        user_action_result = BaseAuthApi.sign_user_action_challenge(
+            self._http, signed_challenge
+        )
+        user_action_token = user_action_result["userAction"]
+
+        return self._http.request_with_user_action(
+            method="POST",
+            path="/staking/stakes/{stakeId}/actions",
+            path_params={"stakeId": stake_id},
+            query_params=None,
+            body=body,
+            user_action=user_action_token,
+        )
+
+    def get_stakes(self, stake_id: str, query: Optional[T.GetStakesQuery] = None) -> T.GetStakesResponse:
+        """
+        Get Stakes.
+
+        Retrieve the details of a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.GetStakesResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}",
+            path_params={"stakeId": stake_id},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def get_stake_rewards(self, stake_id: str) -> T.GetStakeRewardsResponse:
+        """
+        Get Stake Rewards.
+
+        Retrieves the rewards linked to a specific stake.
+
+        Args:
+        stake_id: Path parameter.
+
+        Returns:
+            T.GetStakeRewardsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/staking/stakes/{stakeId}/rewards",
+            path_params={"stakeId": stake_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )

dfns_sdk/generated/staking/types.py

@@ -0,0 +1,64 @@
+"""Types for the staking domain."""
+
+from typing import Any, Literal, NotRequired, Optional, TypedDict, Union
+
+class ListStakesResponse(TypedDict, total=False):
+    """listStakes response."""
+
+    items: list[TypedDict]
+    next_page_token: NotRequired[str]
+
+class ListStakesQuery(TypedDict, total=False):
+    """listStakes query parameters."""
+
+    limit: NotRequired[int]
+    pagination_token: NotRequired[str]
+
+class CreateStakeRequest(TypedDict, total=False):
+    """createStake request body."""
+
+    external_id: NotRequired[str]
+
+class CreateStakeResponse(TypedDict, total=False):
+    """createStake response."""
+
+    actions: list[TypedDict]
+
+class ListStakeActionsResponse(TypedDict, total=False):
+    """listStakeActions response."""
+
+    items: list[TypedDict]
+    next_page_token: NotRequired[str]
+
+class ListStakeActionsQuery(TypedDict, total=False):
+    """listStakeActions query parameters."""
+
+    limit: NotRequired[int]
+    pagination_token: NotRequired[str]
+
+class CreateStakeActionRequest(TypedDict, total=False):
+    """createStakeAction request body."""
+
+    external_id: NotRequired[str]
+
+class CreateStakeActionResponse(TypedDict, total=False):
+    """createStakeAction response."""
+
+    actions: list[TypedDict]
+
+class GetStakesResponse(TypedDict, total=False):
+    """getStakes response."""
+
+    actions: list[TypedDict]
+
+class GetStakesQuery(TypedDict, total=False):
+    """getStakes query parameters."""
+
+    limit: NotRequired[int]
+    pagination_token: NotRequired[str]
+
+class GetStakeRewardsResponse(TypedDict, total=False):
+    """getStakeRewards response."""
+
+    symbol: str
+    balance: str

dfns_sdk/generated/swaps/__init__.py

@@ -0,0 +1,7 @@
+"""Swaps domain module."""
+
+from .client import SwapsClient
+from .delegated_client import DelegatedSwapsClient
+from . import types
+
+__all__ = ["SwapsClient", "DelegatedSwapsClient", "types"]

dfns_sdk/generated/swaps/client.py

@@ -0,0 +1,118 @@
+"""Client for the swaps domain."""
+
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from . import types as T
+
+
+class SwapsClient:
+    """Client for swaps operations."""
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def list_swaps(self, query: Optional[T.ListSwapsQuery] = None) -> T.ListSwapsResponse:
+        """
+        List Swaps.
+
+        List all swaps with pagination
+
+        Args:
+        query: Query parameters.
+
+        Returns:
+            T.ListSwapsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/swaps",
+            path_params={},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_swap(self, body: T.CreateSwapRequest) -> T.CreateSwapResponse:
+        """
+        Create Swap.
+
+        Create a new swap based on an existing quote. This is the second step of the [Swap flow](https://docs.dfns.co/api-reference/swaps#flow-overview).
+
+        Args:
+        body: Request body.
+
+        Returns:
+            T.CreateSwapResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/swaps",
+            path_params={},
+            query_params=None,
+            body=body,
+            requires_signature=True,
+        )
+
+    def request_swap_quote(self, body: T.RequestSwapQuoteRequest) -> T.RequestSwapQuoteResponse:
+        """
+        Request Swap Quote.
+
+        Request a quote from a given provider for swapping assets. This is the first step of the [Swap flow](https://docs.dfns.co/api-reference/swaps#flow-overview).
+
+        Args:
+        body: Request body.
+
+        Returns:
+            T.RequestSwapQuoteResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/swaps/quotes",
+            path_params={},
+            query_params=None,
+            body=body,
+            requires_signature=False,
+        )
+
+    def get_swap(self, swap_id: str) -> T.GetSwapResponse:
+        """
+        Get Swap.
+
+        Get details of a specific swap by its ID
+
+        Args:
+        swap_id: Id of the swap for which we want to get details.
+
+        Returns:
+            T.GetSwapResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/swaps/{swapId}",
+            path_params={"swapId": swap_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )
+
+    def get_swap_quote(self, quote_id: str) -> T.GetSwapQuoteResponse:
+        """
+        Get Swap Quote.
+
+        Get details of a specific swap quote by its ID
+
+        Args:
+        quote_id: The ID of the Swap Quote.
+
+        Returns:
+            T.GetSwapQuoteResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/swaps/quotes/{quoteId}",
+            path_params={"quoteId": quote_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )