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

dfns_sdk/generated/keys/types.py

@@ -0,0 +1,229 @@
+"""Types for the keys domain."""
+
+from typing import Any, Literal, NotRequired, Optional, TypedDict, Union
+
+class ListKeysResponse(TypedDict, total=False):
+    """listKeys response."""
+
+    items: list[TypedDict]
+    next_page_token: NotRequired[str]
+
+class ListKeysQuery(TypedDict, total=False):
+    """listKeys query parameters."""
+
+    limit: NotRequired[str]
+    pagination_token: NotRequired[str]
+    owner: NotRequired[str]
+
+class CreateKeyRequest(TypedDict, total=False):
+    """createKey request body."""
+
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    name: NotRequired[str]
+    master_key: NotRequired[bool]
+    derive_from: NotRequired[TypedDict]
+    store_id: NotRequired[str]
+    delegate_to: NotRequired[str]
+    delay_delegation: NotRequired[bool]
+
+class CreateKeyResponse(TypedDict, total=False):
+    """createKey response."""
+
+    id: str
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    public_key: str
+    master_key: NotRequired[bool]
+    derived_from: NotRequired[TypedDict]
+    name: NotRequired[str]
+    status: Literal["Active", "Archived"]
+    custodial: bool
+    date_created: str
+    imported: NotRequired[bool]
+    exported: NotRequired[bool]
+    date_exported: NotRequired[str]
+    date_deleted: NotRequired[str]
+
+class DelegateKeyRequest(TypedDict, total=False):
+    """delegateKey request body."""
+
+    delegate_to: str
+
+class DelegateKeyResponse(TypedDict, total=False):
+    """delegateKey response."""
+
+    key_id: str
+    status: Literal["Delegated"]
+
+class GetKeyResponse(TypedDict, total=False):
+    """getKey response."""
+
+    id: str
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    public_key: str
+    master_key: NotRequired[bool]
+    derived_from: NotRequired[TypedDict]
+    name: NotRequired[str]
+    status: Literal["Active", "Archived"]
+    custodial: bool
+    date_created: str
+    imported: NotRequired[bool]
+    exported: NotRequired[bool]
+    date_exported: NotRequired[str]
+    date_deleted: NotRequired[str]
+    wallets: list[TypedDict]
+    store: TypedDict
+
+class UpdateKeyRequest(TypedDict, total=False):
+    """updateKey request body."""
+
+    name: Any
+
+class UpdateKeyResponse(TypedDict, total=False):
+    """updateKey response."""
+
+    id: str
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    public_key: str
+    master_key: NotRequired[bool]
+    derived_from: NotRequired[TypedDict]
+    name: NotRequired[str]
+    status: Literal["Active", "Archived"]
+    custodial: bool
+    date_created: str
+    imported: NotRequired[bool]
+    exported: NotRequired[bool]
+    date_exported: NotRequired[str]
+    date_deleted: NotRequired[str]
+
+class DeleteKeyResponse(TypedDict, total=False):
+    """deleteKey response."""
+
+    id: str
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    public_key: str
+    master_key: NotRequired[bool]
+    derived_from: NotRequired[TypedDict]
+    name: NotRequired[str]
+    status: Literal["Active", "Archived"]
+    custodial: bool
+    date_created: str
+    imported: NotRequired[bool]
+    exported: NotRequired[bool]
+    date_exported: NotRequired[str]
+    date_deleted: NotRequired[str]
+
+class DeriveKeyRequest(TypedDict, total=False):
+    """deriveKey request body."""
+
+    domain: str
+    seed: str
+
+class DeriveKeyResponse(TypedDict, total=False):
+    """deriveKey response."""
+
+    output: str
+
+class ExportKeyRequest(TypedDict, total=False):
+    """exportKey request body."""
+
+    encryption_key: str
+    supported_schemes: list[TypedDict]
+
+class ExportKeyResponse(TypedDict, total=False):
+    """exportKey response."""
+
+    public_key: str
+    protocol: Union[Literal["CGGMP24", "FROST", "FROST_BITCOIN", "GLOW20_DH", "KU23"], Literal["CGGMP21"]]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    min_signers: float
+    encrypted_key_shares: list[TypedDict]
+
+class ListSignaturesResponse(TypedDict, total=False):
+    """listSignatures response."""
+
+    key_id: str
+    items: list[TypedDict]
+    next_page_token: NotRequired[str]
+
+class ListSignaturesQuery(TypedDict, total=False):
+    """listSignatures query parameters."""
+
+    limit: NotRequired[str]
+    pagination_token: NotRequired[str]
+
+class GenerateSignatureResponse(TypedDict, total=False):
+    """generateSignature response."""
+
+    id: str
+    key_id: str
+    requester: TypedDict
+    request_body: TypedDict
+    status: Literal["Pending", "Executing", "Signed", "Confirmed", "Failed", "Rejected"]
+    reason: NotRequired[str]
+    signature: NotRequired[TypedDict]
+    signatures: NotRequired[list[TypedDict]]
+    signed_data: NotRequired[str]
+    network: NotRequired[Literal["Algorand", "AlgorandTestnet", "Aptos", "AptosTestnet", "ArbitrumOne", "ArbitrumSepolia", "ArcTestnet", "AvalancheC", "AvalancheCFuji", "BabylonGenesis", "BabylonTestnet5", "Base", "BaseSepolia", "Berachain", "BerachainBepolia", "Bitcoin", "BitcoinSignet", "BitcoinTestnet3", "BitcoinCash", "Bob", "BobSepolia", "Bsc", "BscTestnet", "Canton", "CantonTestnet", "Cardano", "CardanoPreprod", "Concordium", "ConcordiumTestnet", "Celo", "CeloAlfajores", "Codex", "CodexSepolia", "CosmosHub4", "CosmosIcsTestnet", "Dogecoin", "Ethereum", "EthereumClassic", "EthereumClassicMordor", "EthereumGoerli", "EthereumSepolia", "EthereumHolesky", "EthereumHoodi", "FantomOpera", "FantomTestnet", "FlareC", "FlareCCoston2", "FlowEvm", "FlowEvmTestnet", "Hedera", "HederaTestnet", "Ink", "InkSepolia", "InternetComputer", "Ion", "IonTestnet", "Iota", "IotaTestnet", "Kaspa", "Kusama", "KusamaAssetHub", "Litecoin", "Near", "NearTestnet", "Optimism", "OptimismSepolia", "Origyn", "Plasma", "PlasmaTestnet", "Plume", "PlumeSepolia", "Paseo", "PaseoAssetHub", "Polkadot", "PolkadotAssetHub", "Polygon", "PolygonAmoy", "Polymesh", "PolymeshTestnet", "Race", "RaceSepolia", "SeiAtlantic2", "SeiPacific1", "Solana", "SolanaDevnet", "Starknet", "StarknetSepolia", "Stellar", "StellarTestnet", "Sui", "SuiTestnet", "Tezos", "TezosGhostnet", "TempoAndantino", "Tsc", "TscTestnet1", "Ton", "TonTestnet", "Tron", "TronNile", "Westend", "WestendAssetHub", "XrpLedger", "XrpLedgerTestnet"]]
+    tx_hash: NotRequired[str]
+    fee: NotRequired[str]
+    approval_id: NotRequired[str]
+    date_requested: str
+    date_policy_resolved: NotRequired[str]
+    date_signed: NotRequired[str]
+    date_confirmed: NotRequired[str]
+    external_id: NotRequired[str]
+
+class GetSignatureResponse(TypedDict, total=False):
+    """getSignature response."""
+
+    id: str
+    key_id: str
+    requester: TypedDict
+    request_body: TypedDict
+    status: Literal["Pending", "Executing", "Signed", "Confirmed", "Failed", "Rejected"]
+    reason: NotRequired[str]
+    signature: NotRequired[TypedDict]
+    signatures: NotRequired[list[TypedDict]]
+    signed_data: NotRequired[str]
+    network: NotRequired[Literal["Algorand", "AlgorandTestnet", "Aptos", "AptosTestnet", "ArbitrumOne", "ArbitrumSepolia", "ArcTestnet", "AvalancheC", "AvalancheCFuji", "BabylonGenesis", "BabylonTestnet5", "Base", "BaseSepolia", "Berachain", "BerachainBepolia", "Bitcoin", "BitcoinSignet", "BitcoinTestnet3", "BitcoinCash", "Bob", "BobSepolia", "Bsc", "BscTestnet", "Canton", "CantonTestnet", "Cardano", "CardanoPreprod", "Concordium", "ConcordiumTestnet", "Celo", "CeloAlfajores", "Codex", "CodexSepolia", "CosmosHub4", "CosmosIcsTestnet", "Dogecoin", "Ethereum", "EthereumClassic", "EthereumClassicMordor", "EthereumGoerli", "EthereumSepolia", "EthereumHolesky", "EthereumHoodi", "FantomOpera", "FantomTestnet", "FlareC", "FlareCCoston2", "FlowEvm", "FlowEvmTestnet", "Hedera", "HederaTestnet", "Ink", "InkSepolia", "InternetComputer", "Ion", "IonTestnet", "Iota", "IotaTestnet", "Kaspa", "Kusama", "KusamaAssetHub", "Litecoin", "Near", "NearTestnet", "Optimism", "OptimismSepolia", "Origyn", "Plasma", "PlasmaTestnet", "Plume", "PlumeSepolia", "Paseo", "PaseoAssetHub", "Polkadot", "PolkadotAssetHub", "Polygon", "PolygonAmoy", "Polymesh", "PolymeshTestnet", "Race", "RaceSepolia", "SeiAtlantic2", "SeiPacific1", "Solana", "SolanaDevnet", "Starknet", "StarknetSepolia", "Stellar", "StellarTestnet", "Sui", "SuiTestnet", "Tezos", "TezosGhostnet", "TempoAndantino", "Tsc", "TscTestnet1", "Ton", "TonTestnet", "Tron", "TronNile", "Westend", "WestendAssetHub", "XrpLedger", "XrpLedgerTestnet"]]
+    tx_hash: NotRequired[str]
+    fee: NotRequired[str]
+    approval_id: NotRequired[str]
+    date_requested: str
+    date_policy_resolved: NotRequired[str]
+    date_signed: NotRequired[str]
+    date_confirmed: NotRequired[str]
+    external_id: NotRequired[str]
+
+class ImportKeyRequest(TypedDict, total=False):
+    """importKey request body."""
+
+    name: NotRequired[str]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    protocol: Union[Literal["CGGMP24", "FROST", "FROST_BITCOIN", "GLOW20_DH", "KU23"], Literal["CGGMP21"]]
+    min_signers: int
+    encrypted_key_shares: list[TypedDict]
+    master_key: NotRequired[bool]
+
+class ImportKeyResponse(TypedDict, total=False):
+    """importKey response."""
+
+    id: str
+    scheme: Literal["DH", "ECDSA", "EdDSA", "Schnorr"]
+    curve: Literal["ed25519", "secp256k1", "stark"]
+    public_key: str
+    master_key: NotRequired[bool]
+    derived_from: NotRequired[TypedDict]
+    name: NotRequired[str]
+    status: Literal["Active", "Archived"]
+    custodial: bool
+    date_created: str
+    imported: NotRequired[bool]
+    exported: NotRequired[bool]
+    date_exported: NotRequired[str]
+    date_deleted: NotRequired[str]

dfns_sdk/generated/networks/__init__.py

@@ -0,0 +1,7 @@
+"""Networks domain module."""
+
+from .client import NetworksClient
+from .delegated_client import DelegatedNetworksClient
+from . import types
+
+__all__ = ["NetworksClient", "DelegatedNetworksClient", "types"]

dfns_sdk/generated/networks/client.py

@@ -0,0 +1,176 @@
+"""Client for the networks domain."""
+
+from typing import Any, Literal, Optional, TypedDict, Union
+
+from ..._internal import HttpClient
+from . import types as T
+
+
+class NetworksClient:
+    """Client for networks operations."""
+
+    def __init__(self, http_client: HttpClient):
+        self._http = http_client
+
+    def estimate_fees(self, query: T.EstimateFeesQuery) -> TypedDict:
+        """
+        Estimate Fees.
+
+        Gets real-time fee details for a given network, allowing users to make decisions based on their preferences for transaction speed/priority. Three levels of priority will be displayed: `slow`, `standard`, `fast`.
+
+        Args:
+        query: Query parameters.
+
+        Returns:
+            TypedDict: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/fees",
+            path_params={},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def read_contract(self, body: dict[str, Any]) -> T.ReadContractResponse:
+        """
+        Read Contract.
+
+        Call a read-only function on a smart contract. In Solidity, this use the `view` keyword.
+
+  <Note>
+  Currently only works on EVM compatible chains.
+  </Note>
+
+        Args:
+        body: Request body.
+
+        Returns:
+            T.ReadContractResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/networks/read-contract",
+            path_params={},
+            query_params=None,
+            body=body,
+            requires_signature=False,
+        )
+
+    def get_canton_validator(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str) -> T.GetCantonValidatorResponse:
+        """
+        Get Canton Validator.
+
+        Return a configured Canton Validator in your organization.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+
+        Returns:
+            T.GetCantonValidatorResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )
+
+    def update_canton_validator(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str, body: T.UpdateCantonValidatorRequest) -> T.UpdateCantonValidatorResponse:
+        """
+        Update Canton Validator.
+
+        Update an existing Canton Validator configuration.
+  
+  Read details about the process [here](https://docs.dfns.co/networks/canton-validators).
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+        body: Request body.
+
+        Returns:
+            T.UpdateCantonValidatorResponse: The API response.
+        """
+        return self._http.request(
+            method="PUT",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=body,
+            requires_signature=True,
+        )
+
+    def delete_canton_validator(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str) -> T.DeleteCantonValidatorResponse:
+        """
+        Delete Canton Validator.
+
+        Delete a specific Canton Validator configuration.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+
+        Returns:
+            T.DeleteCantonValidatorResponse: The API response.
+        """
+        return self._http.request(
+            method="DELETE",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=None,
+            requires_signature=True,
+        )
+
+    def list_canton_validators(self, network: Literal["canton", "canton-devnet", "canton-testnet"], query: Optional[T.ListCantonValidatorsQuery] = None) -> T.ListCantonValidatorsResponse:
+        """
+        List Canton Validators.
+
+        Retrieve the list of configured Canton Validators in your organization.
+
+        Args:
+        network: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.ListCantonValidatorsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/{network}/validators",
+            path_params={"network": network},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_canton_validator(self, network: Literal["canton", "canton-devnet", "canton-testnet"], body: dict[str, Any]) -> T.CreateCantonValidatorResponse:
+        """
+        Create Canton Validator.
+
+        Link a Canton Validator to your organization. This is required in order to create wallets or interact with the Canton network.
+
+  The `Shared` option allows you to use a shared validator hosted by DFNS and get started in seconds, while the `Custom` option allows you to connect your own validator and ledger nodes using OAuth2 authentication.
+
+  Read details about the process [here](https://docs.dfns.co/networks/canton-validators).
+
+        Args:
+        network: Path parameter.
+        body: Request body.
+
+        Returns:
+            T.CreateCantonValidatorResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/networks/{network}/validators",
+            path_params={"network": network},
+            query_params=None,
+            body=body,
+            requires_signature=True,
+        )

dfns_sdk/generated/networks/delegated_client.py

@@ -0,0 +1,274 @@
+"""Delegated client for the networks 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 DelegatedNetworksClient:
+    """
+    Delegated client for networks 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 estimate_fees(self, query: T.EstimateFeesQuery) -> TypedDict:
+        """
+        Estimate Fees.
+
+        Gets real-time fee details for a given network, allowing users to make decisions based on their preferences for transaction speed/priority. Three levels of priority will be displayed: `slow`, `standard`, `fast`.
+
+        Args:
+        query: Query parameters.
+
+        Returns:
+            TypedDict: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/fees",
+            path_params={},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def read_contract(self, body: dict[str, Any]) -> T.ReadContractResponse:
+        """
+        Read Contract.
+
+        Call a read-only function on a smart contract. In Solidity, this use the `view` keyword.
+
+  <Note>
+  Currently only works on EVM compatible chains.
+  </Note>
+
+        Args:
+        body: Request body.
+
+        Returns:
+            T.ReadContractResponse: The API response.
+        """
+        return self._http.request(
+            method="POST",
+            path="/networks/read-contract",
+            path_params={},
+            query_params=None,
+            body=body,
+            requires_signature=False,
+        )
+
+    def get_canton_validator(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str) -> T.GetCantonValidatorResponse:
+        """
+        Get Canton Validator.
+
+        Return a configured Canton Validator in your organization.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+
+        Returns:
+            T.GetCantonValidatorResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=None,
+            requires_signature=False,
+        )
+
+    def update_canton_validator_init(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str, body: T.UpdateCantonValidatorRequest) -> UserActionChallengeResponse:
+        """
+        Initialize Update Canton Validator.
+
+        Creates a user action challenge for external signing.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+        body: Request body.
+
+        Returns:
+            UserActionChallengeResponse: The challenge to sign externally.
+        """
+        path = "/networks/{network}/validators/{validatorId}"
+        path = path.replace("{network}", str(network))
+        path = path.replace("{validatorId}", str(validator_id))
+        payload = json.dumps(body, separators=(",", ":")) if body else ""
+
+        return BaseAuthApi.create_user_action_challenge(
+            self._http,
+            user_action_http_method="PUT",
+            user_action_http_path=path,
+            user_action_payload=payload,
+        )
+
+    def update_canton_validator_complete(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str, body: T.UpdateCantonValidatorRequest, signed_challenge: SignUserActionChallengeRequest) -> T.UpdateCantonValidatorResponse:
+        """
+        Complete Update Canton Validator.
+
+        Submits the signed challenge and makes the API request.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+        body: Request body.
+        signed_challenge: The signed challenge from external signing.
+
+        Returns:
+            T.UpdateCantonValidatorResponse: 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="PUT",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=body,
+            user_action=user_action_token,
+        )
+
+    def delete_canton_validator_init(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str) -> UserActionChallengeResponse:
+        """
+        Initialize Delete Canton Validator.
+
+        Creates a user action challenge for external signing.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+
+        Returns:
+            UserActionChallengeResponse: The challenge to sign externally.
+        """
+        path = "/networks/{network}/validators/{validatorId}"
+        path = path.replace("{network}", str(network))
+        path = path.replace("{validatorId}", str(validator_id))
+        payload = ""
+
+        return BaseAuthApi.create_user_action_challenge(
+            self._http,
+            user_action_http_method="DELETE",
+            user_action_http_path=path,
+            user_action_payload=payload,
+        )
+
+    def delete_canton_validator_complete(self, network: Literal["canton", "canton-devnet", "canton-testnet"], validator_id: str, signed_challenge: SignUserActionChallengeRequest) -> T.DeleteCantonValidatorResponse:
+        """
+        Complete Delete Canton Validator.
+
+        Submits the signed challenge and makes the API request.
+
+        Args:
+        network: Path parameter.
+        validator_id: Path parameter.
+        signed_challenge: The signed challenge from external signing.
+
+        Returns:
+            T.DeleteCantonValidatorResponse: 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="DELETE",
+            path="/networks/{network}/validators/{validatorId}",
+            path_params={"network": network, "validatorId": validator_id},
+            query_params=None,
+            body=None,
+            user_action=user_action_token,
+        )
+
+    def list_canton_validators(self, network: Literal["canton", "canton-devnet", "canton-testnet"], query: Optional[T.ListCantonValidatorsQuery] = None) -> T.ListCantonValidatorsResponse:
+        """
+        List Canton Validators.
+
+        Retrieve the list of configured Canton Validators in your organization.
+
+        Args:
+        network: Path parameter.
+        query: Query parameters.
+
+        Returns:
+            T.ListCantonValidatorsResponse: The API response.
+        """
+        return self._http.request(
+            method="GET",
+            path="/networks/{network}/validators",
+            path_params={"network": network},
+            query_params=query,
+            body=None,
+            requires_signature=False,
+        )
+
+    def create_canton_validator_init(self, network: Literal["canton", "canton-devnet", "canton-testnet"], body: dict[str, Any]) -> UserActionChallengeResponse:
+        """
+        Initialize Create Canton Validator.
+
+        Creates a user action challenge for external signing.
+
+        Args:
+        network: Path parameter.
+        body: Request body.
+
+        Returns:
+            UserActionChallengeResponse: The challenge to sign externally.
+        """
+        path = "/networks/{network}/validators"
+        path = path.replace("{network}", str(network))
+        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_canton_validator_complete(self, network: Literal["canton", "canton-devnet", "canton-testnet"], body: dict[str, Any], signed_challenge: SignUserActionChallengeRequest) -> T.CreateCantonValidatorResponse:
+        """
+        Complete Create Canton Validator.
+
+        Submits the signed challenge and makes the API request.
+
+        Args:
+        network: Path parameter.
+        body: Request body.
+        signed_challenge: The signed challenge from external signing.
+
+        Returns:
+            T.CreateCantonValidatorResponse: 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="/networks/{network}/validators",
+            path_params={"network": network},
+            query_params=None,
+            body=body,
+            user_action=user_action_token,
+        )