dominusnode-agno

Agno tools for the DominusNode AI-agent relay network (v2). Agents fetch the web through exit IPs contributed by other operators, pay per GB from a prepaid wallet (live prices from dominusnode_network_pricing, nothing hardcoded), and can earn by contributing their own IP with the DominusNode node agent.

Built on the official dominusnode Python SDK v2: all HTTP, SSRF and DNS-rebinding checks, gateway username flags and validation come from the SDK.

pip install dominusnode-agno
export DOMINUSNODE_API_KEY=dn_live_...   # read from the environment, never a tool argument

Defaults: API https://api.dominusnode.daedalusdevelopmentgroup.com, relay gateway proxy.dominusnode.daedalusdevelopmentgroup.com. Override with DOMINUSNODE_BASE_URL / DOMINUSNODE_PROXY_HOST.

Usage

from agno.agent import Agent
from agno.models.anthropic import Claude
from dominusnode_agno import DominusNodeToolkit

agent = Agent(model=Claude(id="claude-sonnet-4-5"), tools=[DominusNodeToolkit()])
agent.print_response("What does a residential GB cost on DominusNode right now?")

DominusNodeToolkit is an agno.tools.Toolkit named dominusnode; Agno builds each tool's schema from the method signature and docstring. Use include_tools=[...]/exclude_tools=[...] to narrow the set. Errors come back as scrubbed Error: ... strings.

The 19 tools

Security

• The API key comes from DOMINUSNODE_API_KEY (or constructor config). It is never a tool argument, never in a tool schema and never in tool output; dominusnode_proxy_url returns a <DOMINUSNODE_API_KEY> placeholder.
• Every result and error is scrubbed of dn_live_/dn_test_/dn_node_/dn_proxy_ keys and JWTs.
• dominusnode_fetch (via the SDK): GET/HEAD only, ports 80/443, private/local hosts and DNS-rebinding refused, redirects not followed, 10 MB cap, sanctioned countries refused. Plaintext http:// needs allow_http=true and is visible to the exit node.
• Signed flows (node registration, withdrawals, payout wallet) are not LLM tools: use the DominusNode MCP server, the node agent, or the SDK with a signer key file.

Configuration env vars: DOMINUSNODE_API_KEY, DOMINUSNODE_BASE_URL, DOMINUSNODE_PROXY_HOST, DOMINUSNODE_PROXY_PORT.

Development

pip install -e ../../sdks/python -e '.[dev]'
pytest

License

MIT