dfns-sdk 0.0.0.dev0__tar.gz

dfns_sdk-0.0.0.dev0/.github/workflows/publish.yml

@@ -0,0 +1,52 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install pypa/build
+        run: >-
+          python3 -m
+          pip install
+          build
+          --user
+      - name: Build a binary wheel and a source tarball
+        run: python3 -m build
+      - name: Store the distribution packages
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/dfns_sdk
+    permissions:
+      id-token: write
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v6
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

dfns_sdk-0.0.0.dev0/.gitignore

@@ -0,0 +1,6 @@
+
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.pyc

dfns_sdk-0.0.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dfns
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dfns_sdk-0.0.0.dev0/PKG-INFO

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: dfns_sdk
+Version: 0.0.0.dev0
+Summary: Dfns Python SDK - Auto-generated from OpenAPI specification
+Project-URL: Documentation, https://docs.dfns.co
+Project-URL: Repository, https://github.com/dfns/dfns-sdk-python
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Dfns Python SDK
+
+Auto-generated Python SDK for the Dfns API.
+
+## Installation
+
+```bash
+pip install dfns_sdk
+```
+
+Or install from source:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig
+
+# Configure the client
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+    base_url="https://api.dfns.io",  # Optional, this is the default
+)
+
+# Create the client
+client = DfnsClient(config)
+
+# Use the client
+wallets = client.wallets.list_wallets()
+print(wallets)
+
+# Clean up
+client.close()
+```
+
+## Using as a Context Manager
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig
+
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+)
+
+with DfnsClient(config) as client:
+    wallets = client.wallets.list_wallets()
+    print(wallets)
+```
+
+## User Action Signing
+
+Some operations (like creating wallets or signing transactions) require user action signing.
+Configure a signer to enable these operations:
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig, KeySigner
+
+# Load your private key
+with open("private_key.pem") as f:
+    private_key = f.read()
+
+# Create a signer
+signer = KeySigner(
+    credential_id="cr-xxx-xxx",  # Your credential ID
+    private_key=private_key,
+    app_origin="https://app.dfns.io",
+)
+
+# Configure the client with the signer
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+    signer=signer,
+)
+
+with DfnsClient(config) as client:
+    # Operations requiring signatures will automatically sign
+    wallet = client.wallets.create_wallet({
+        "network": "EthereumSepolia",
+    })
+    print(wallet)
+```
+
+## Delegated Client (External Signing)
+
+For service accounts that orchestrate signing externally (e.g., using a separate signing service),
+use the `DfnsDelegatedClient`. This client separates user action signing into `*_init()` and
+`*_complete()` method pairs:
+
+```python
+from dfns_sdk import DfnsDelegatedClient, DfnsDelegatedClientConfig
+
+# Configure the delegated client (no signer needed)
+config = DfnsDelegatedClientConfig(
+    auth_token="service-account-token",
+)
+
+with DfnsDelegatedClient(config) as client:
+    # Step 1: Initialize the action (returns challenge)
+    challenge = client.wallets.create_wallet_init(
+        body={"network": "EthereumSepolia"}
+    )
+
+    # Step 2: Sign challenge externally (your signing system)
+    # The challenge contains everything needed to sign:
+    # - challenge["challenge"]: The challenge string to sign
+    # - challenge["challengeIdentifier"]: Unique ID for this challenge
+    signed_assertion = your_external_signer.sign(challenge)
+
+    # Step 3: Complete the action with signed challenge
+    wallet = client.wallets.create_wallet_complete(
+        body={"network": "EthereumSepolia"},
+        signed_challenge={
+            "challengeIdentifier": challenge["challengeIdentifier"],
+            "firstFactor": signed_assertion,
+        },
+    )
+    print(wallet)
+```
+
+### When to Use Delegated vs Regular Client
+
+| Use Case | Client Type |
+|----------|-------------|
+| Single application with embedded signing | `DfnsClient` |
+| Mobile app with local key storage | `DfnsClient` |
+| Backend service with external HSM | `DfnsDelegatedClient` |
+| Multi-step approval workflows | `DfnsDelegatedClient` |
+| Service account orchestrating user actions | `DfnsDelegatedClient` |
+
+## Available Domains
+
+The client provides access to the following API domains:
+
+- `client.auth` - Authentication and user management
+- `client.wallets` - Wallet operations
+- `client.policies` - Policy management
+- `client.permissions` - Permission management
+- `client.webhooks` - Webhook subscriptions
+- And more...
+
+Each domain provides typed methods for all available API endpoints.
+
+## Error Handling
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig, DfnsError
+
+config = DfnsClientConfig(auth_token="your-auth-token")
+client = DfnsClient(config)
+
+try:
+    wallet = client.wallets.get_wallet(wallet_id="invalid-id")
+except DfnsError as e:
+    print(f"Error: {e.message}")
+    print(f"Status: {e.status_code}")
+    print(f"Code: {e.error_code}")
+```
+
+## License
+
+MIT License - See LICENSE file for details.

dfns_sdk-0.0.0.dev0/README.md

@@ -0,0 +1,164 @@
+# Dfns Python SDK
+
+Auto-generated Python SDK for the Dfns API.
+
+## Installation
+
+```bash
+pip install dfns_sdk
+```
+
+Or install from source:
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig
+
+# Configure the client
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+    base_url="https://api.dfns.io",  # Optional, this is the default
+)
+
+# Create the client
+client = DfnsClient(config)
+
+# Use the client
+wallets = client.wallets.list_wallets()
+print(wallets)
+
+# Clean up
+client.close()
+```
+
+## Using as a Context Manager
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig
+
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+)
+
+with DfnsClient(config) as client:
+    wallets = client.wallets.list_wallets()
+    print(wallets)
+```
+
+## User Action Signing
+
+Some operations (like creating wallets or signing transactions) require user action signing.
+Configure a signer to enable these operations:
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig, KeySigner
+
+# Load your private key
+with open("private_key.pem") as f:
+    private_key = f.read()
+
+# Create a signer
+signer = KeySigner(
+    credential_id="cr-xxx-xxx",  # Your credential ID
+    private_key=private_key,
+    app_origin="https://app.dfns.io",
+)
+
+# Configure the client with the signer
+config = DfnsClientConfig(
+    auth_token="your-auth-token",
+    signer=signer,
+)
+
+with DfnsClient(config) as client:
+    # Operations requiring signatures will automatically sign
+    wallet = client.wallets.create_wallet({
+        "network": "EthereumSepolia",
+    })
+    print(wallet)
+```
+
+## Delegated Client (External Signing)
+
+For service accounts that orchestrate signing externally (e.g., using a separate signing service),
+use the `DfnsDelegatedClient`. This client separates user action signing into `*_init()` and
+`*_complete()` method pairs:
+
+```python
+from dfns_sdk import DfnsDelegatedClient, DfnsDelegatedClientConfig
+
+# Configure the delegated client (no signer needed)
+config = DfnsDelegatedClientConfig(
+    auth_token="service-account-token",
+)
+
+with DfnsDelegatedClient(config) as client:
+    # Step 1: Initialize the action (returns challenge)
+    challenge = client.wallets.create_wallet_init(
+        body={"network": "EthereumSepolia"}
+    )
+
+    # Step 2: Sign challenge externally (your signing system)
+    # The challenge contains everything needed to sign:
+    # - challenge["challenge"]: The challenge string to sign
+    # - challenge["challengeIdentifier"]: Unique ID for this challenge
+    signed_assertion = your_external_signer.sign(challenge)
+
+    # Step 3: Complete the action with signed challenge
+    wallet = client.wallets.create_wallet_complete(
+        body={"network": "EthereumSepolia"},
+        signed_challenge={
+            "challengeIdentifier": challenge["challengeIdentifier"],
+            "firstFactor": signed_assertion,
+        },
+    )
+    print(wallet)
+```
+
+### When to Use Delegated vs Regular Client
+
+| Use Case | Client Type |
+|----------|-------------|
+| Single application with embedded signing | `DfnsClient` |
+| Mobile app with local key storage | `DfnsClient` |
+| Backend service with external HSM | `DfnsDelegatedClient` |
+| Multi-step approval workflows | `DfnsDelegatedClient` |
+| Service account orchestrating user actions | `DfnsDelegatedClient` |
+
+## Available Domains
+
+The client provides access to the following API domains:
+
+- `client.auth` - Authentication and user management
+- `client.wallets` - Wallet operations
+- `client.policies` - Policy management
+- `client.permissions` - Permission management
+- `client.webhooks` - Webhook subscriptions
+- And more...
+
+Each domain provides typed methods for all available API endpoints.
+
+## Error Handling
+
+```python
+from dfns_sdk import DfnsClient, DfnsClientConfig, DfnsError
+
+config = DfnsClientConfig(auth_token="your-auth-token")
+client = DfnsClient(config)
+
+try:
+    wallet = client.wallets.get_wallet(wallet_id="invalid-id")
+except DfnsError as e:
+    print(f"Error: {e.message}")
+    print(f"Status: {e.status_code}")
+    print(f"Code: {e.error_code}")
+```
+
+## License
+
+MIT License - See LICENSE file for details.

dfns_sdk-0.0.0.dev0/dfns_sdk/__init__.py

@@ -0,0 +1,24 @@
+"""Dfns Python SDK - Auto-generated from OpenAPI specification."""
+
+from .client import DfnsClient
+from .delegated_client import DfnsDelegatedClient
+from .types import DfnsClientConfig, DfnsDelegatedClientConfig, DfnsError
+from .auth import Signer, KeySigner
+from .base_auth_api import (
+    BaseAuthApi,
+    UserActionChallengeResponse,
+    SignUserActionChallengeRequest,
+)
+
+__all__ = [
+    "DfnsClient",
+    "DfnsDelegatedClient",
+    "DfnsClientConfig",
+    "DfnsDelegatedClientConfig",
+    "DfnsError",
+    "Signer",
+    "KeySigner",
+    "BaseAuthApi",
+    "UserActionChallengeResponse",
+    "SignUserActionChallengeRequest",
+]

dfns_sdk-0.0.0.dev0/dfns_sdk/_internal/__init__.py

@@ -0,0 +1,5 @@
+"""Internal modules."""
+
+from .http_client import HttpClient, AsyncHttpClient
+
+__all__ = ["HttpClient", "AsyncHttpClient"]