dominusnode 2.0.0__py3-none-any.whl

dominusnode-2.0.0.dist-info/METADATA

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: dominusnode
+Version: 2.0.0
+Summary: Official DominusNode SDK for Python: AI-agent relay network (proxy, nodes, credits, payouts)
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/0xcircuitbreaker/DomiNode/tree/master/sdks/python
+Project-URL: Repository, https://github.com/0xcircuitbreaker/DomiNode
+Project-URL: Issues, https://github.com/0xcircuitbreaker/DomiNode/issues
+Project-URL: Changelog, https://github.com/0xcircuitbreaker/DomiNode/blob/master/sdks/python/CHANGELOG.md
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Dynamic: license-file
+
+# dominusnode — DominusNode Python SDK (v2)
+
+Python client for the DominusNode AI-agent relay network: proxy through relay nodes,
+register your own nodes, earn credits and withdraw payouts. It implements
+[`sdks/SDK_SURFACE.md`](../SDK_SURFACE.md) (15 resources, 71 methods), with the Node SDK as
+the reference implementation.
+
+- Sync `DominusNodeClient` and asyncio `AsyncDominusNodeClient` with the same methods
+- One dependency (`httpx`), no crypto dependency: you sign through a callback
+- Python 3.9+, type hints, PEP 561
+
+```bash
+pip install dominusnode
+```
+
+Defaults: API `https://api.dominusnode.daedalusdevelopmentgroup.com`, relay gateway `proxy.dominusnode.daedalusdevelopmentgroup.com` (HTTP proxy :8080, SOCKS5 :1080). Both can be overridden in the client configuration.
+
+## Quick start
+
+```python
+import os
+from dominusnode import DominusNodeClient
+
+with DominusNodeClient() as dn:
+    dn.connect_with_key(os.environ["DOMINUSNODE_API_KEY"])  # dn_live_... / dn_test_...
+
+    print(dn.network.pricing())       # live per-GB prices (µUSD); the SDK hardcodes no prices
+    res = dn.proxy.fetch("https://example.com", country="US", ip_class="residential")
+    print(res.status, res.text()[:200])
+```
+
+Async:
+
+```python
+from dominusnode import AsyncDominusNodeClient
+
+async with AsyncDominusNodeClient() as dn:
+    await dn.connect_with_key(key)
+    stats = await dn.network.stats()
+```
+
+## Proxy
+
+Routing flags go in the proxy **username**, the API key in the **password**:
+
+```python
+dn.proxy.build_username(country="DE", session_id="abc123")  # "country-DE-session-abc123"
+url = dn.proxy.build_url(country="US", ip_class="dc")        # http://country-US-class-dc:<key>@proxy.dominusnode.daedalusdevelopmentgroup.com:8080
+```
+
+`build_url` returns a URL that **contains your API key: do not log it.**
+
+Flags: `country` (ISO-2; OFAC countries CU IR KP RU SY are refused), `ip_class`
+(`residential`/`dc`/`mobile`), `session_id` (sticky, 1-64 alphanumerics),
+`agentic_wallet_id` (UUID, spend from an agentic wallet), `allow_http` (`allowhttp-1`).
+With no flags the username is `relay`.
+
+`proxy.fetch(url, ...)` sends GET or HEAD only. Before it opens a connection it checks the
+URL: http(s) only, ports 80/443, no userinfo, no local or private hosts, including
+decimal/hex/octal IPv4 forms and IPv6 forms that embed IPv4. It then resolves the hostname
+and refuses it if *any* address is private (DNS-rebinding check). https goes through a
+CONNECT tunnel with full TLS verification; `http://` needs `allow_http=True`. Redirects are
+returned as they are, not followed, and the body is capped at 10 MB (`truncated=True` when
+cut).
+
+## Signers (EIP-191)
+
+Node registration, withdrawals, payout-wallet changes and wallet sign-in need a signature from
+your wallet. Pass any object with an `address` and a `sign_message(message) -> "0x…"` method that
+performs `personal_sign`:
+
+```python
+from eth_account import Account
+from eth_account.messages import encode_defunct
+
+acct = Account.from_key(private_key)
+
+class Signer:
+    address = acct.address
+    def sign_message(self, message: str) -> str:
+        sig = acct.sign_message(encode_defunct(text=message)).signature.hex()
+        return sig if sig.startswith("0x") else "0x" + sig
+```
+
+With `AsyncDominusNodeClient`, `sign_message` may be `async def`.
+
+The SDK never signs a server string without checking it. For every signed flow it builds the
+expected message itself and compares it byte for byte with the server's. If they differ, it
+raises `ProtocolError` and the signer is never called.
+
+```python
+node = dn.nodes.register(signer, node_pubkey=ed25519_pub_hex, max_streams=8)
+node_key = node["nodeKey"].reveal()       # Secret, shown once
+
+dn.payout_wallet.set("0xYourPayoutAddress", signer)               # first set
+dn.payout_wallet.set("0xNew...", signer, old_wallet_signer=old)   # change: old wallet co-signs
+
+r = dn.credits.withdraw(5_000_000, signer)   # µUSD (int or digit string, never float); $5
+r["idempotencyKey"]                          # reuse it to retry safely
+```
+
+## Money
+
+- Server money values are `{"musd": "<integer µUSD>", "usd": "<6 decimals>"}`; 1 USD = 1,000,000 µUSD.
+- µUSD inputs accept an `int` or a digit string and are sent as decimal strings. Floats, NaN and Infinity are rejected.
+- `*_cents` inputs are integers with `0 < x <= 2,147,483,647`, checked before any request is sent.
+
+## Resources
+
+| Resource | Methods |
+|---|---|
+| `auth` | `verify_key`, `refresh`, `logout`, `me` |
+| `wallet_auth` | `challenge`, `verify`, `sign_in`, `link` |
+| `keys` | `create`, `list`, `revoke` |
+| `wallet` | `get_balance`, `get_transactions`, `get_forecast`, `top_up_crypto`, `get_crypto_status` |
+| `agentic_wallets` | `create`, `list`, `get`, `fund`, `update_wallet_policy`, `transactions`, `freeze`, `unfreeze`, `delete` |
+| `teams` | 18 methods: team CRUD, wallet, members, invites, keys (`create_key` … `revoke_key`) |
+| `usage` | `get`, `get_daily`, `get_top_hosts`, `export_csv` (`from_`/`to` -> `since`/`until`) |
+| `sessions` | `get_active` (id, startedAt and status only; never IPs), `report` |
+| `x402` | `get_info` |
+| `network` | `policy`, `pricing`, `stats` |
+| `nodes` | `register_challenge`, `register`, `list`, `revoke`, `update_caps`, `tier` |
+| `credits` | `balance`, `transactions`, `convert`, `withdraw` |
+| `payout_wallet` | `get`, `set` |
+| `payouts` | `list` |
+| `proxy` | `build_username`, `build_url`, `fetch`, `get_health`, `get_config` |
+
+Client members: `connect_with_key(api_key)` (returns `{"mfaRequired": bool, "userId"?}`),
+`disconnect()` and `is_connected`. Results are the server's JSON as dicts with camelCase keys.
+
+Not in the SDK: plans, slots, admin, Stripe and PayPal top-ups, email/password and human MFA.
+Use the dashboard for those.
+
+## Errors
+
+`DominusNodeError` (`message`, `status_code`, `code`, `details`) and its subclasses:
+`ValidationError` (HTTP 400, and client-side checks with `code="INVALID_ARGUMENT"`),
+`AuthenticationError`, `InsufficientBalanceError`, `AuthorizationError`, `NotFoundError`,
+`ConflictError`, `RateLimitError` (`retry_after_seconds`), `ServerError`, `NetworkError`,
+`ProtocolError`, `ProxyError`. Error messages are scrubbed of `dn_live_`/`dn_test_`/`dn_node_`/
+`dn_proxy_` keys and JWTs.
+
+## Security behaviour
+
+- Redirects are never followed. API responses are capped at 10 MB.
+- On 429 the SDK retries once, waiting `min(Retry-After, 10 s)` ±10 % (at least 100 ms).
+- On 401 it refreshes the JWT once. `/v1` routes send the raw API key and are not refreshed.
+- `Secret` (new API keys, team keys, node keys) prints and serialises as `[REDACTED]`. Use `json.dumps(obj, default=dominusnode.json_default)`.
+- `disconnect()` logs out (best effort), then clears the API key and both tokens.
+
+## Development
+
+```bash
+pip install -e '.[dev]'
+pytest
+```
+
+`tests/fixtures/signed_messages.json` holds the three signed messages as produced by the Node
+SDK builders. `tests/test_signers.py` checks the Python builders against it byte for byte.

dominusnode-2.0.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+dominusnode/__init__.py,sha256=8ahNc7lk0-85qmkuYOiTTVvnovKpuxZ1WEoF_Q80IlU,1742
+dominusnode/_ops.py,sha256=39eR8QjFZBREhw3WbPTae5AoHfHoxHXHQ0cgl0nWbrg,4040
+dominusnode/client.py,sha256=8d_5BGbDrOcthExqEy8K-5uG4cr7ENjNi2dhr3BSJUM,7645
+dominusnode/constants.py,sha256=ixevquxzIXYCvob2QkwLUS36b9z-G6Q3YjEyxMjr6No,1036
+dominusnode/errors.py,sha256=HwwMzwbai7HQdykEASkuMaSVbw37mtSclkPzOp8_GTQ,4812
+dominusnode/http_client.py,sha256=sIec9f2lw2yKe1fEsSy5vJGFqgEY27MIdp11r8nV3yU,12743
+dominusnode/messages.py,sha256=9Aq4dVxLwPR4D5q5vDcHJdk5gLMukx65JgaL0sn2oTw,2599
+dominusnode/pow.py,sha256=W7QI2vCNoYUi31um_7ybYrmwtwQfFkbaIFu8Q3Yc2FU,1108
+dominusnode/proxy_fetch.py,sha256=fmwwZ-Dl3X7qqP9yNP2O_N-YxYr0NHSdKzadGzarL54,12576
+dominusnode/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dominusnode/resources.py,sha256=lZ2G17WLMsRSfCjXMbeMfqxeel68g6EY-mA7JvTuu74,35318
+dominusnode/secret.py,sha256=C8zmibccK3Cs4TAlZTjpUTxZfOoMxZoBBS1yruSW41I,1697
+dominusnode/signer.py,sha256=oqTzS9sy3OSPsUynKWi6Q0KuySG3UT_D2WuZX3nkV0c,2053
+dominusnode/ssrf.py,sha256=tUoDBjKGPzO0zDoXrQ2j1LiiI3RKonrgmnMIZ9nsgsg,6109
+dominusnode/token_manager.py,sha256=HS2lEN8tMU7b1iJr6m3e9zYy08qwNGKmMpb5A64RZIM,4965
+dominusnode/types.py,sha256=7_sNH4dJbwG4zDpNQiI-zVDwLbVb7-jIOcn7BtoKPiQ,1930
+dominusnode/validation.py,sha256=7yoni-aSewGwWvMD-ZdlCec6C6l8nNZXcFE5F0oM_C0,4483
+dominusnode-2.0.0.dist-info/licenses/LICENSE,sha256=NBkjfgN0tpbJjWf7uqsPCOMgq7uuSEW4uaGDCpB8HbI,1069
+dominusnode-2.0.0.dist-info/METADATA,sha256=urbXNUEqWJIIuwA-ZE08-gBWXoaaSvCbYENexJrSqj8,7771
+dominusnode-2.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+dominusnode-2.0.0.dist-info/top_level.txt,sha256=xUsTotK5cVkWFeLnn6BJMeUjd7M-Y7_Amo8JawImfco,12
+dominusnode-2.0.0.dist-info/RECORD,,

dominusnode-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dominusnode-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominus Node
+
+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.

dominusnode-2.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dominusnode