dominusnode 2.0.0__tar.gz → 2.0.1__tar.gz

{dominusnode-2.0.0 → dominusnode-2.0.1}/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [2.0.1] - 2026-11-12
+
+No breaking changes: every 2.0.0 public name and type still exists.
+
+### Fixed
+- Team keys read the server's `prefix` field (falls back to `keyPrefix`); key lists
+  expose `userId`, `teamId` and `revokedAt`.
+- Proxy health returns `{ status }` only, matching the server.
+- Team invites carry `invitedBy`.
+- Credits cursor validation matches the server (`^[1-9][0-9]{0,18}$`).
+- 409 responses (e.g. `REPORT_LIMIT`) are never retried and surface with their `code`;
+  429 is retried at most once.
+- A malformed `Content-Length` response header raises `ServerError` instead of being ignored.
+
+### Added
+- `buyerDiscountBps` on credits balance and tier views, `buyerDiscounts` on pricing,
+  `seed`/`community` blocks on network stats.
+- Payout wallet `chain` accepts `base-sepolia` as an explicit opt-in (server decides).
+- Pagination helpers for credit transactions, payouts, nodes, usage records and
+  wallet transactions.
+- README: PoW/client-IP note and a troubleshooting table.
+
+### Deprecated
+- The `keyPrefix` key in team-key results: use `prefix` (same value).
+
 ## [2.0.0] - 2026-11-06
 
 Breaking: rewritten for the v2 relay-network contract (`sdks/SDK_SURFACE.md`, reference `sdks/node` 2.0.0).

{dominusnode-2.0.0/dominusnode.egg-info → dominusnode-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominusnode
-Version: 2.0.0
+Version: 2.0.1
 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
@@ -175,3 +175,21 @@ 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.
+
+## Node registration and the client IP
+
+The node-registration proof-of-work is bound to the client IP that requested it.
+Call the register-challenge and register methods from the same egress (same machine,
+same outbound IP, no proxy or VPN switch in between); otherwise the server rejects
+the solution with `INVALID_CHALLENGE`. Register from the host that will run the node.
+
+## Troubleshooting
+
+| Symptom | Meaning | What to do |
+|---|---|---|
+| HTTP 402 | API call: requester or agentic wallet balance is too low | Top up with crypto or fund the agentic wallet |
+| HTTP 407 (proxy) | Gateway rejected the proxy credentials | Check the API key in the proxy password and the username flags (`country-XX-class-dc-...`, or `relay`) |
+| `EMAIL_NOT_VERIFIED` | The route needs a verified account | Verify the account before financial calls |
+| `NO_NODES_AVAILABLE` | No eligible exit node for the requested country/class | Relax the country/class flags or retry later; check network stats |
+| `PAYOUTS_DISABLED` | Withdrawals are switched off server-side | Keep earning; the credits balance `payoutsEnabled` field shows the state |
+| `REPORT_LIMIT` | Per-node daily session-report cap reached (HTTP 409 conflict error; older servers 429) | Do not retry today; the SDK never retries it |

{dominusnode-2.0.0 → dominusnode-2.0.1}/README.md

@@ -157,3 +157,21 @@ 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.
+
+## Node registration and the client IP
+
+The node-registration proof-of-work is bound to the client IP that requested it.
+Call the register-challenge and register methods from the same egress (same machine,
+same outbound IP, no proxy or VPN switch in between); otherwise the server rejects
+the solution with `INVALID_CHALLENGE`. Register from the host that will run the node.
+
+## Troubleshooting
+
+| Symptom | Meaning | What to do |
+|---|---|---|
+| HTTP 402 | API call: requester or agentic wallet balance is too low | Top up with crypto or fund the agentic wallet |
+| HTTP 407 (proxy) | Gateway rejected the proxy credentials | Check the API key in the proxy password and the username flags (`country-XX-class-dc-...`, or `relay`) |
+| `EMAIL_NOT_VERIFIED` | The route needs a verified account | Verify the account before financial calls |
+| `NO_NODES_AVAILABLE` | No eligible exit node for the requested country/class | Relax the country/class flags or retry later; check network stats |
+| `PAYOUTS_DISABLED` | Withdrawals are switched off server-side | Keep earning; the credits balance `payoutsEnabled` field shows the state |
+| `REPORT_LIMIT` | Per-node daily session-report cap reached (HTTP 409 conflict error; older servers 429) | Do not retry today; the SDK never retries it |

{dominusnode-2.0.0 → dominusnode-2.0.1}/dominusnode/constants.py

@@ -1,6 +1,6 @@
 """SDK-wide constants (mirrors sdks/node/src/constants.ts)."""
 
-SDK_VERSION = "2.0.0"
+SDK_VERSION = "2.0.1"
 USER_AGENT = f"dominusnode-sdk-python/{SDK_VERSION}"
 DEFAULT_BASE_URL = "https://api.dominusnode.daedalusdevelopmentgroup.com"
 DEFAULT_PROXY_HOST = "proxy.dominusnode.daedalusdevelopmentgroup.com"

{dominusnode-2.0.0 → dominusnode-2.0.1}/dominusnode/http_client.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import asyncio
 import json
 import random
+import re
 import time
 from dataclasses import dataclass, field
 from typing import Any, Callable, Dict, Optional, Union
@@ -157,11 +158,18 @@ def _content(req: Request) -> Optional[bytes]:
     return None if req.body is _NO_BODY else json.dumps(req.body).encode("utf-8")
 
 
+_CONTENT_LENGTH_RE = re.compile(r"^[0-9]{1,19}\Z")
+
+
 def _too_large_by_header(res: httpx.Response) -> bool:
-    try:
-        return int(res.headers.get("content-length", "0")) > MAX_RESPONSE_BYTES
-    except ValueError:
+    """True when Content-Length exceeds the cap; a malformed value raises ServerError."""
+    raw = res.headers.get("content-length")
+    if raw is None:
         return False
+    value = raw.strip()
+    if not _CONTENT_LENGTH_RE.match(value):
+        raise ServerError("Malformed Content-Length header in response", res.status_code)
+    return int(value) > MAX_RESPONSE_BYTES
 
 
 def _finish(req: Request, res: httpx.Response, data: bytes) -> Any:

{dominusnode-2.0.0 → dominusnode-2.0.1}/dominusnode/resources.py

@@ -7,7 +7,7 @@ Results are the server's JSON as dicts (camelCase keys, as on the wire); see typ
 from __future__ import annotations
 
 import re
-from typing import Any, Dict, List, Mapping, Optional
+from typing import Any, AsyncIterator, Dict, Iterator, List, Mapping, Optional
 
 from ._ops import Call, Gen, make_variants
 from .constants import DEFAULT_HTTP_PROXY_PORT, DEFAULT_PROXY_HOST, DEFAULT_SOCKS5_PROXY_PORT, DEFAULT_TLS_PROXY_PORT
@@ -254,6 +254,24 @@ class _AgenticWalletResource(_Base):
 
 
 # ---------------------------------------------------------------- 3.6 teams
+def _key_prefix(r: Any) -> str:
+    """Server sends ``prefix``; older servers sent ``keyPrefix``."""
+    if not isinstance(r, dict):
+        return ""
+    p = r.get("prefix", r.get("keyPrefix"))
+    return p if isinstance(p, str) else ""
+
+
+def _team_key(k: Dict[str, Any]) -> Dict[str, Any]:
+    prefix = _key_prefix(k)
+    revoked = k.get("revokedAt")
+    return {
+        "id": k.get("id"), "prefix": prefix, "keyPrefix": prefix, "label": k.get("label"),
+        "userId": k.get("userId"), "teamId": k.get("teamId"), "createdAt": k.get("createdAt"),
+        "revokedAt": revoked if isinstance(revoked, str) else None,
+    }
+
+
 class _TeamsResource(_Base):
     def _t(self, team_id: str) -> str:
         return f"/api/teams/{_id(team_id, 'team_id')}"
@@ -321,13 +339,17 @@ class _TeamsResource(_Base):
         return (yield _post(f"/api/teams/invites/{_id(token, 'token')}/accept", {}))
 
     def create_key(self, team_id: str, label: str) -> Gen:
-        """POST /{teamId}/keys -> {id, keyPrefix, label, key: Secret}. Team keys cannot call /v1 routes."""
+        """POST /{teamId}/keys -> {id, prefix, keyPrefix (alias), label, key: Secret}. Team keys cannot call /v1 routes."""
         validate_non_empty(label, "label", 100)
         r = yield _post(f"{self._t(team_id)}/keys", {"label": label})
-        return {**r, "key": Secret(str(r.get("key", "")))}
+        prefix = _key_prefix(r)
+        return {**r, "prefix": prefix, "keyPrefix": prefix, "key": Secret(str(r.get("key", "")))}
 
     def list_keys(self, team_id: str) -> Gen:
-        return (yield _get(f"{self._t(team_id)}/keys"))
+        """-> {keys: [{id, prefix, keyPrefix (alias), label, userId, teamId, createdAt, revokedAt}]}."""
+        r = yield _get(f"{self._t(team_id)}/keys")
+        keys = r.get("keys") if isinstance(r, dict) else None
+        return {"keys": [_team_key(k) for k in keys if isinstance(k, dict)] if isinstance(keys, list) else []}
 
     def revoke_key(self, team_id: str, key_id: str) -> Gen:
         yield _delete(f"{self._t(team_id)}/keys/{_id(key_id, 'key_id')}")
@@ -544,7 +566,7 @@ MIN_CONVERT_MUSD = 10_000
 MAX_CONVERT_MUSD = 10_000_000_000
 MIN_WITHDRAW_MUSD = 1_000_000
 MAX_WITHDRAW_MUSD = 100_000_000_000
-_CURSOR_RE = re.compile(r"^[0-9]{1,20}\Z")
+_CURSOR_RE = re.compile(r"^[1-9][0-9]{0,18}\Z")
 
 
 def _check_signed_challenge(ch: Any, signer: Any) -> Dict[str, Any]:
@@ -595,6 +617,10 @@ class _CreditsResource(_Base):
 
 
 # ---------------------------------------------------------------- 3.13 payoutWallet
+# base-sepolia is an explicit opt-in for staging; the server decides whether it is accepted.
+PAYOUT_CHAINS = ("base", "base-sepolia")
+
+
 class _PayoutWalletResource(_Base):
     def get(self) -> Gen:
         return (yield _get("/v1/payout-wallet", "agent"))
@@ -603,8 +629,8 @@ class _PayoutWalletResource(_Base):
         """Register or change the payout wallet (old wallet co-signs the SAME message when required)."""
         assert_signer(signer)
         addr = validate_address(address).lower()
-        if chain != "base":
-            raise invalid_arg("chain must be 'base'")
+        if chain not in PAYOUT_CHAINS:
+            raise invalid_arg("chain must be 'base' or 'base-sepolia'")
         if old_wallet_signer is not None:
             assert_signer(old_wallet_signer, "old_wallet_signer")
         ch = yield _post("/v1/payout-wallet/challenge", {"address": addr, "chain": chain}, "agent")
@@ -768,7 +794,10 @@ class _ProxyResource(_Base):
         return result
 
     def get_health(self) -> Gen:
-        return (yield _get("/api/proxy/health", "none"))
+        """-> {status}. The server returns only the gateway status."""
+        r = yield _get("/api/proxy/health", "none")
+        status = r.get("status") if isinstance(r, dict) else None
+        return {"status": status if isinstance(status, str) else "unknown"}
 
     def get_config(self) -> Gen:
         return (yield _get("/api/proxy/config"))
@@ -789,3 +818,98 @@ CreditsResource, AsyncCreditsResource = make_variants(_CreditsResource)
 PayoutWalletResource, AsyncPayoutWalletResource = make_variants(_PayoutWalletResource)
 PayoutsResource, AsyncPayoutsResource = make_variants(_PayoutsResource)
 ProxyResource, AsyncProxyResource = make_variants(_ProxyResource)
+
+
+# ---------------------------------------------------------------- pagination helpers
+# Sync variants are generators, async variants async generators. ``limit`` is the page size.
+_MAX_OFFSET = 1_000_000
+
+
+def _offset_pager(list_method: str, items_key: str, default_limit: int, max_limit: int, total: bool = False) -> Any:
+    def _done(page: Any, items: List[Any], limit: int, offset: int) -> bool:
+        if len(items) < limit:
+            return True
+        if total and isinstance(page, dict):
+            t = (page.get("pagination") or {}).get("total")
+            if isinstance(t, int) and offset + len(items) >= t:
+                return True
+        return False
+
+    def _items(page: Any) -> List[Any]:
+        v = page.get(items_key) if isinstance(page, dict) else None
+        return v if isinstance(v, list) else []
+
+    def sync_iter(self: Any, limit: Optional[int] = None, **kwargs: Any) -> Iterator[Any]:
+        lim = validate_int_range(default_limit if limit is None else limit, "limit", 1, max_limit)
+        offset = 0
+        while offset <= _MAX_OFFSET:
+            page = getattr(self, list_method)(limit=lim, offset=offset, **kwargs)
+            items = _items(page)
+            yield from items
+            if _done(page, items, lim, offset):
+                return
+            offset += lim
+
+    async def async_iter(self: Any, limit: Optional[int] = None, **kwargs: Any) -> AsyncIterator[Any]:
+        lim = validate_int_range(default_limit if limit is None else limit, "limit", 1, max_limit)
+        offset = 0
+        while offset <= _MAX_OFFSET:
+            page = await getattr(self, list_method)(limit=lim, offset=offset, **kwargs)
+            items = _items(page)
+            for item in items:
+                yield item
+            if _done(page, items, lim, offset):
+                return
+            offset += lim
+
+    return sync_iter, async_iter
+
+
+def _next_cursor(page: Any, items: List[Any], cursor: Optional[str]) -> Optional[str]:
+    nxt = page.get("nextCursor") if isinstance(page, dict) else None
+    if not items or not isinstance(nxt, str) or not _CURSOR_RE.match(nxt) or nxt == cursor:
+        return None
+    return nxt
+
+
+def _credit_items(page: Any) -> List[Any]:
+    v = page.get("transactions") if isinstance(page, dict) else None
+    return v if isinstance(v, list) else []
+
+
+def _credits_iter_sync(self: Any, limit: Optional[int] = None, type: Optional[str] = None, cursor: Optional[str] = None) -> Iterator[Any]:  # noqa: A002
+    """Every credit transaction (newest first), following nextCursor."""
+    while True:
+        page = self.transactions(limit=limit, cursor=cursor, type=type)
+        items = _credit_items(page)
+        yield from items
+        cursor = _next_cursor(page, items, cursor)
+        if cursor is None:
+            return
+
+
+async def _credits_iter_async(self: Any, limit: Optional[int] = None, type: Optional[str] = None, cursor: Optional[str] = None) -> AsyncIterator[Any]:  # noqa: A002
+    """Every credit transaction (newest first), following nextCursor."""
+    while True:
+        page = await self.transactions(limit=limit, cursor=cursor, type=type)
+        items = _credit_items(page)
+        for item in items:
+            yield item
+        cursor = _next_cursor(page, items, cursor)
+        if cursor is None:
+            return
+
+
+CreditsResource.iter_transactions = _credits_iter_sync  # type: ignore[attr-defined]
+AsyncCreditsResource.iter_transactions = _credits_iter_async  # type: ignore[attr-defined]
+for _sync_cls, _async_cls, _name, _args in (
+    (PayoutsResource, AsyncPayoutsResource, "iterate", ("list", "payouts", 50, 200)),
+    (NodesResource, AsyncNodesResource, "iterate", ("list", "nodes", 100, 500)),
+    (WalletResource, AsyncWalletResource, "iter_transactions", ("get_transactions", "transactions", 50, 100)),
+):
+    _s, _a = _offset_pager(*_args)
+    setattr(_sync_cls, _name, _s)
+    setattr(_async_cls, _name, _a)
+_s, _a = _offset_pager("get", "records", 200, 1000, total=True)
+UsageResource.iter_records = _s  # type: ignore[attr-defined]
+AsyncUsageResource.iter_records = _a  # type: ignore[attr-defined]

{dominusnode-2.0.0 → dominusnode-2.0.1}/dominusnode/types.py

@@ -95,5 +95,54 @@ class NetworkPricing(TypedDict):
     unit: str
     prices: List[PricingEntry]
     nodeShare: List[Dict[str, object]]
+    buyerDiscounts: List["BuyerDiscount"]
     maturationHours: int
     rails: List[str]
+
+
+class BuyerDiscount(TypedDict):
+    tier: str
+    rank: int
+    buyerDiscountBps: int
+
+
+class NetworkGroupStats(TypedDict):
+    """Online nodes and paid bytes (decimal string) in the last 24h for one operator group."""
+
+    online: int
+    paidBytes24h: str
+
+
+class NetworkStats(TypedDict):
+    onlineNodes: int
+    byClass: Dict[str, int]
+    byCountry: List[Dict[str, object]]
+    otherCountries: int
+    seed: NetworkGroupStats
+    community: NetworkGroupStats
+    generatedAt: str
+
+
+class TeamKey(TypedDict):
+    id: str
+    prefix: str
+    keyPrefix: str
+    label: str
+    userId: str
+    teamId: str
+    createdAt: str
+    revokedAt: Optional[str]
+
+
+class TeamInvite(TypedDict):
+    id: str
+    teamId: str
+    email: str
+    role: str
+    invitedBy: str
+    expiresAt: str
+    createdAt: str
+
+
+class ProxyHealth(TypedDict):
+    status: str

{dominusnode-2.0.0 → dominusnode-2.0.1/dominusnode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominusnode
-Version: 2.0.0
+Version: 2.0.1
 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
@@ -175,3 +175,21 @@ 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.
+
+## Node registration and the client IP
+
+The node-registration proof-of-work is bound to the client IP that requested it.
+Call the register-challenge and register methods from the same egress (same machine,
+same outbound IP, no proxy or VPN switch in between); otherwise the server rejects
+the solution with `INVALID_CHALLENGE`. Register from the host that will run the node.
+
+## Troubleshooting
+
+| Symptom | Meaning | What to do |
+|---|---|---|
+| HTTP 402 | API call: requester or agentic wallet balance is too low | Top up with crypto or fund the agentic wallet |
+| HTTP 407 (proxy) | Gateway rejected the proxy credentials | Check the API key in the proxy password and the username flags (`country-XX-class-dc-...`, or `relay`) |
+| `EMAIL_NOT_VERIFIED` | The route needs a verified account | Verify the account before financial calls |
+| `NO_NODES_AVAILABLE` | No eligible exit node for the requested country/class | Relax the country/class flags or retry later; check network stats |
+| `PAYOUTS_DISABLED` | Withdrawals are switched off server-side | Keep earning; the credits balance `payoutsEnabled` field shows the state |
+| `REPORT_LIMIT` | Per-node daily session-report cap reached (HTTP 409 conflict error; older servers 429) | Do not retry today; the SDK never retries it |

{dominusnode-2.0.0 → dominusnode-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominusnode"
-version = "2.0.0"
+version = "2.0.1"
 readme = "README.md"
 description = "Official DominusNode SDK for Python: AI-agent relay network (proxy, nodes, credits, payouts)"
 requires-python = ">=3.9"