dominusnode-autogpt

AutoGPT 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-autogpt
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 dominusnode_autogpt import DominusNodePlugin

plugin = DominusNodePlugin()                       # reads DOMINUSNODE_API_KEY
DominusNodePlugin.get_commands()                   # 19 commands with JSON-schema parameters
plugin.handle_command("dominusnode_network_pricing", {})
plugin.handle_command("dominusnode_fetch", {"url": "https://example.com", "country": "DE"})

DominusNodePlugin implements the classic AutoGPT command-plugin hooks (can_handle_post_prompt / post_prompt, which calls prompt.add_command for each command) and a framework-free handle_command(name, args) dispatcher you can wire into any AutoGPT agent loop. Unknown commands and unexpected arguments (such as an api_key) are refused. Results and errors are scrubbed 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