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

dfns_sdk-0.0.0.dev0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,69 @@
+dfns_sdk/__init__.py,sha256=r713JvK6MpdhbwWtHAfUboXWvkYbikWGGR8Ak7gaS_8,633
+dfns_sdk/auth.py,sha256=tnFisi-CS4brELaF_ijQw1EMpLI7KSw0yGRSxEHHH88,4070
+dfns_sdk/base_auth_api.py,sha256=eYkbuo-Nqsnjw9x08aZ8jJXCrV1cZudrwKf9tcm3ono,4081
+dfns_sdk/client.py,sha256=5cub7coYVmQNryNCyfMmlRNyr9JYtAYiofAma7fQ28w,2722
+dfns_sdk/delegated_client.py,sha256=jqhmNGoBlXd_D7FzHdeVa4Y9iPaUWTu-jifYQM7ZGgs,4037
+dfns_sdk/types.py,sha256=YwCItuhDMZOHAh2NqBN1vIVLtYA2-GZEIHFsJQDz25o,1980
+dfns_sdk/_internal/__init__.py,sha256=3bjrRUeJFrYtJyP_jzLY96Vz7GaWksUAl4e7TSU12u8,123
+dfns_sdk/_internal/http_client.py,sha256=J1Trm_w0TRdq3vNoUhFYJvOcD2NR5t67kE3emc9okt4,12459
+dfns_sdk/generated/__init__.py,sha256=8soAjjLI61cxiaUXxrR4HUuHLmAsHixTuKF3bfp0Apw,1649
+dfns_sdk/generated/agreements/__init__.py,sha256=Ydmb2bw1Z1HLdXkMjRG5TgjatPYCZVAvOeom8QQv7ls,216
+dfns_sdk/generated/agreements/client.py,sha256=kwnsjzi1GEgNmDJUg5VrRUO7ZNGnAEtZ8Z8QF1Q27kg,1605
+dfns_sdk/generated/agreements/delegated_client.py,sha256=Pp-g5bjhZbDz-tGeyEDZs3GfAUsWtOX9WSU5cr9YViQ,3001
+dfns_sdk/generated/agreements/types.py,sha256=wt_ExoYCEaEXxXT0B7czbM2EP2RW1YqzxYHu6f9l5FY,673
+dfns_sdk/generated/allocations/__init__.py,sha256=c_LvEK60ZcAHMF6grw5lXCItLaaaenwuc2P8Oh4Mf_0,221
+dfns_sdk/generated/allocations/client.py,sha256=oKiyIJhmLIJKeSl5cPQDl1ttcgKszzltc4sJeyseDTs,3424
+dfns_sdk/generated/allocations/delegated_client.py,sha256=rETRLOkGT9SBs828-Bs0Rri6XcA2SMFfVrtB2Ka20X8,6030
+dfns_sdk/generated/allocations/types.py,sha256=XJtjQcAET6ysF2q8jR6fhTy5RXpnqduSFtrtwAvgyZA,1811
+dfns_sdk/generated/auth/__init__.py,sha256=A97NTPmfMWtXNKKPhCL9c_SDQFvawRVaxko0SIamW-w,186
+dfns_sdk/generated/auth/client.py,sha256=ajsQR9kLgn2fiH684CWyc51XrcTf20MTAZ2FVFj4D1g,41659
+dfns_sdk/generated/auth/delegated_client.py,sha256=JOBP14seTHQEOD1Hu9GIreeKZcCxq3Ly02NWzvyDM2g,62964
+dfns_sdk/generated/auth/types.py,sha256=6gneh7R4QoR6MDmu-23WWgMm2EXmP08yjgAT0cx192w,19804
+dfns_sdk/generated/exchanges/__init__.py,sha256=XRKSeUE26Mt-CWLPx3I9Ysq-DsXAN7bcXb7d_Yd9UgU,211
+dfns_sdk/generated/exchanges/client.py,sha256=WpvQ7Ybehtn1RMZqlMEZ0VjqinizS6Kc1XjFJhkYoKI,6486
+dfns_sdk/generated/exchanges/delegated_client.py,sha256=GWvn4TyMyDDv5_kehIh_TN1lBR6G6VnIGdj-K_jyLFI,11720
+dfns_sdk/generated/exchanges/types.py,sha256=icihRKgXr9m_PrvPw2tB3GTYt4Grrb4znUL7ckaElic,2634
+dfns_sdk/generated/fee_sponsors/__init__.py,sha256=vjcT_ERyboUq94nh50aa5B3CrEcSVcenHyBdrn590fU,221
+dfns_sdk/generated/fee_sponsors/client.py,sha256=_pVFu9rBFWn3N0QSZG5IQ_LFERRaOa0jZ6O4nqMUaYw,4925
+dfns_sdk/generated/fee_sponsors/delegated_client.py,sha256=FzcytCZpOgPD6cxt0CxYjYD6NaiRF48o68nlorJT0K0,9343
+dfns_sdk/generated/fee_sponsors/types.py,sha256=axa7P5FhFM9QAivcRts0656pCquDYpWrYwQ5HDz5ecc,2422
+dfns_sdk/generated/keys/__init__.py,sha256=PX2cpn59WkzBIgg5GCD0CFI1efR3kZO8LK1I2c0ikDo,186
+dfns_sdk/generated/keys/client.py,sha256=c71COrVoHv4ZICBvGPFrMmFa9s-hdEadaKU8umH5cy4,12266
+dfns_sdk/generated/keys/delegated_client.py,sha256=wRsU-2e8wvDzo-fJNq7l1CYpLc0MNE3SBjXTUp8OaMI,16030
+dfns_sdk/generated/keys/types.py,sha256=yh75Oqr5BOba9QyqP3OxuxHuCcLAJh_521UxWRhOvMg,9630
+dfns_sdk/generated/networks/__init__.py,sha256=9_DAHLxDJ49h3rEdcY90mVHHNTCSwloS1AyHWDusWmU,206
+dfns_sdk/generated/networks/client.py,sha256=3YWJOCsvkPebPZNSW6BoPHIqK_ppx2OgJH73IzHqjWE,5838
+dfns_sdk/generated/networks/delegated_client.py,sha256=h-FykEl2Id_WfEbIaQKFoSmGVB9kaOk1kRyHF8Ju8qM,9477
+dfns_sdk/generated/networks/types.py,sha256=PbTE5uFFgIekvabntZM7LnGcpKny_5fBlhxcRs9wOCE,2944
+dfns_sdk/generated/permissions/__init__.py,sha256=GOqAukp6nloLUpTsIb2yf_nVLMXCKvf0uNNsLgVerrU,221
+dfns_sdk/generated/permissions/client.py,sha256=2ssMzoUHilr4B5eiia9suEYxf_uA-iKpmekPsXAxDmU,5784
+dfns_sdk/generated/permissions/delegated_client.py,sha256=rrzJorRzppQCYOjPOdbAdEB073m2zCMeATaMnJCUXLY,11662
+dfns_sdk/generated/permissions/types.py,sha256=nGBc2LG5vgxr3JKqQeqzLUgY1UFwvsXdY73c-FQ7u50,8316
+dfns_sdk/generated/policies/__init__.py,sha256=qO6-1InMycXnFWsDBt_PMOVglybZjVNBA2twd4tBiBY,206
+dfns_sdk/generated/policies/client.py,sha256=p6UnzNuu0_g5ofh78F0W0GJm7-P619wVRY8w3TZ3vB4,5472
+dfns_sdk/generated/policies/delegated_client.py,sha256=dBjaDWc1MEsfd3cLQ7DKGciMvU6dW3wQF4G6N1lcvI8,9550
+dfns_sdk/generated/policies/types.py,sha256=3NY_0ZGpBpBZfBXq9BNqNzraTH5xmusv_KyqqevEM7g,2090
+dfns_sdk/generated/signers/__init__.py,sha256=qgXrd3jln5xLeLarvZvS7m9uL8XVauZejk8Fyg3R750,201
+dfns_sdk/generated/signers/client.py,sha256=LhJr_szT2AlNE50Sl0nt4yac9U0VpfIXSnNkgTMFFpY,1102
+dfns_sdk/generated/signers/delegated_client.py,sha256=dCBtk4Uw6LH0bfHqhqdeHgsSs9eQvz4eFOggffTLbkg,1423
+dfns_sdk/generated/signers/types.py,sha256=BIPiPiUtaYSJIhEOJkgMHx72CR2A6jt4uVzl2cWmx10,341
+dfns_sdk/generated/staking/__init__.py,sha256=a7PWHFgvXixvn5zK9C2vXX0iLoIRnvqDH78fYMtxhVE,201
+dfns_sdk/generated/staking/client.py,sha256=L29rubkabhRt83gdfS5pOGIjBiTzI5zxw4_g12L6yQ8,3818
+dfns_sdk/generated/staking/delegated_client.py,sha256=iPYARaGWgzxyVwdMxlg2NXRvje6YJlNHxv8_lk1N81A,6363
+dfns_sdk/generated/staking/types.py,sha256=2yVvckLrQzGX0cDXX_w6BujhZQGjXs5GgEvm_FGixPs,1625
+dfns_sdk/generated/swaps/__init__.py,sha256=r4CZwNFnQp37K-rQDgieehsXih7ULY54Avb-IkHubhA,191
+dfns_sdk/generated/swaps/client.py,sha256=9Rf_J40WX2R7s_MmT4l_okOH6J1OjAjOLwgtEA7qM_8,3190
+dfns_sdk/generated/swaps/delegated_client.py,sha256=Kh8e4WryOUqZfm5IOhIt2jHLaHF9sFmqaT0lrMKEwfY,4425
+dfns_sdk/generated/swaps/types.py,sha256=9bQ5UGlM7VYLuqTymI5mjrPU89WDZis-1YNAhrKCsYc,2735
+dfns_sdk/generated/wallets/__init__.py,sha256=uagPUuhF3qCwDwbacg692s9waP80Bpkpyh0Msc_CgP8,201
+dfns_sdk/generated/wallets/client.py,sha256=59O6S7881gWrZ6Az7ZdGuBIur8tmTom8KEk2R028KhM,28770
+dfns_sdk/generated/wallets/delegated_client.py,sha256=HMYOAA9jD-9Y1oGvSa5B3z2rNuCXkCrwlI8CBc2te-o,40604
+dfns_sdk/generated/wallets/types.py,sha256=4SOqIZaC2c9xDqeb_qAbIiWe9sGYRGqF9ZKYHwwpYR0,49586
+dfns_sdk/generated/webhooks/__init__.py,sha256=emS73MMdbYNzeeTqneszCPM8DrBkoMQ8QzhZVvHtd6o,206
+dfns_sdk/generated/webhooks/client.py,sha256=SYamVxkblk0zNpBNCrxmOSC_upoaqnGmdAHrHBxf8_k,5962
+dfns_sdk/generated/webhooks/delegated_client.py,sha256=pkT9s5re4jSZlpzhm3rbJaAtPT6bg6RBCEgCU9qskgk,10373
+dfns_sdk/generated/webhooks/types.py,sha256=MwiHLPQNyGc1A41q2ubaPweRz0FmLTbjLBSjCzQMZqQ,8036
+dfns_sdk-0.0.0.dev0.dist-info/METADATA,sha256=bipnMFaTyYlQgLdK714YaMymtPvXllDp12iKGyQwY2Y,5211
+dfns_sdk-0.0.0.dev0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+dfns_sdk-0.0.0.dev0.dist-info/licenses/LICENSE,sha256=CN73yx-Wis-FNVmAWjK1BbzjuHDJ6ityv6RtszrZj_I,1061
+dfns_sdk-0.0.0.dev0.dist-info/RECORD,,

dfns_sdk-0.0.0.dev0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dfns_sdk-0.0.0.dev0.dist-info/licenses/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.