dominusnode-superagi 1.0.0__tar.gz

dominusnode_superagi-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 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_superagi-1.0.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.1
+Name: dominusnode-superagi
+Version: 1.0.0
+Summary: DomiNode toolkit for SuperAGI -- 22 proxy, wallet, and team management tools
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=1.10.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+
+# DomiNode SuperAGI Toolkit
+
+SuperAGI toolkit providing 22 tools for interacting with the DomiNode rotating proxy-as-a-service platform.
+
+## Installation
+
+```bash
+pip install dominusnode-superagi
+```
+
+Or install from source:
+
+```bash
+cd integrations/superagi
+pip install -e ".[dev]"
+```
+
+## Configuration
+
+Set the following environment variables (or configure them in SuperAGI's tool configuration):
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `DOMINUSNODE_API_KEY` | Yes | -- | Your DomiNode API key (`dn_live_...` or `dn_test_...`) |
+| `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | DomiNode REST API base URL |
+| `DOMINUSNODE_PROXY_HOST` | No | `proxy.dominusnode.com` | DomiNode proxy gateway hostname |
+| `DOMINUSNODE_PROXY_PORT` | No | `8080` | DomiNode proxy gateway port |
+
+## Usage with SuperAGI
+
+Register the toolkit in your SuperAGI agent:
+
+```python
+from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+# The toolkit registers itself with SuperAGI
+toolkit = DominusNodeToolkit()
+tools = toolkit.get_tools()  # Returns all 22 tool instances
+env_keys = toolkit.get_env_keys()  # Config keys needed
+```
+
+## Available Tools (22)
+
+### Proxy Operations
+- **DomiNode Proxied Fetch** -- Fetch a URL through rotating proxies with geo-targeting
+- **DomiNode Proxy Config** -- Get proxy endpoint configuration
+- **DomiNode List Sessions** -- View active proxy sessions
+
+### Wallet
+- **DomiNode Check Balance** -- View wallet balance
+- **DomiNode Check Usage** -- View usage statistics by period
+- **DomiNode TopUp PayPal** -- Create a PayPal wallet top-up order
+
+### Agentic Wallets
+- **DomiNode Create Agentic Wallet** -- Create a sub-wallet with spending limit
+- **DomiNode Fund Agentic Wallet** -- Transfer from main wallet
+- **DomiNode Agentic Wallet Balance** -- Check sub-wallet balance
+- **DomiNode List Agentic Wallets** -- List all sub-wallets
+- **DomiNode Agentic Transactions** -- Transaction history
+- **DomiNode Freeze Agentic Wallet** -- Temporarily halt spending
+- **DomiNode Unfreeze Agentic Wallet** -- Re-enable spending
+- **DomiNode Delete Agentic Wallet** -- Delete and refund balance
+
+### Teams
+- **DomiNode Create Team** -- Create team with shared wallet
+- **DomiNode List Teams** -- List user's teams
+- **DomiNode Team Details** -- Get team info
+- **DomiNode Team Fund** -- Fund team wallet
+- **DomiNode Team Create Key** -- Create team API key
+- **DomiNode Team Usage** -- Team transaction history
+- **DomiNode Update Team** -- Update team settings
+- **DomiNode Update Team Member Role** -- Change member role
+
+### Payments
+- **DomiNode X402 Info** -- x402 micropayment protocol details
+
+## Security
+
+All tools include:
+- SSRF prevention (private IP blocking, DNS rebinding protection, Teredo/6to4 IPv6 tunnel detection)
+- OFAC sanctioned country blocking (CU, IR, KP, RU, SY)
+- Credential scrubbing in error messages
+- Prototype pollution prevention
+- HTTP method restriction (GET/HEAD/OPTIONS only for proxied fetch)
+- 10 MB response cap, redirect following disabled
+
+## Testing
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_superagi-1.0.0/README.md

@@ -0,0 +1,96 @@
+# DomiNode SuperAGI Toolkit
+
+SuperAGI toolkit providing 22 tools for interacting with the DomiNode rotating proxy-as-a-service platform.
+
+## Installation
+
+```bash
+pip install dominusnode-superagi
+```
+
+Or install from source:
+
+```bash
+cd integrations/superagi
+pip install -e ".[dev]"
+```
+
+## Configuration
+
+Set the following environment variables (or configure them in SuperAGI's tool configuration):
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `DOMINUSNODE_API_KEY` | Yes | -- | Your DomiNode API key (`dn_live_...` or `dn_test_...`) |
+| `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | DomiNode REST API base URL |
+| `DOMINUSNODE_PROXY_HOST` | No | `proxy.dominusnode.com` | DomiNode proxy gateway hostname |
+| `DOMINUSNODE_PROXY_PORT` | No | `8080` | DomiNode proxy gateway port |
+
+## Usage with SuperAGI
+
+Register the toolkit in your SuperAGI agent:
+
+```python
+from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+# The toolkit registers itself with SuperAGI
+toolkit = DominusNodeToolkit()
+tools = toolkit.get_tools()  # Returns all 22 tool instances
+env_keys = toolkit.get_env_keys()  # Config keys needed
+```
+
+## Available Tools (22)
+
+### Proxy Operations
+- **DomiNode Proxied Fetch** -- Fetch a URL through rotating proxies with geo-targeting
+- **DomiNode Proxy Config** -- Get proxy endpoint configuration
+- **DomiNode List Sessions** -- View active proxy sessions
+
+### Wallet
+- **DomiNode Check Balance** -- View wallet balance
+- **DomiNode Check Usage** -- View usage statistics by period
+- **DomiNode TopUp PayPal** -- Create a PayPal wallet top-up order
+
+### Agentic Wallets
+- **DomiNode Create Agentic Wallet** -- Create a sub-wallet with spending limit
+- **DomiNode Fund Agentic Wallet** -- Transfer from main wallet
+- **DomiNode Agentic Wallet Balance** -- Check sub-wallet balance
+- **DomiNode List Agentic Wallets** -- List all sub-wallets
+- **DomiNode Agentic Transactions** -- Transaction history
+- **DomiNode Freeze Agentic Wallet** -- Temporarily halt spending
+- **DomiNode Unfreeze Agentic Wallet** -- Re-enable spending
+- **DomiNode Delete Agentic Wallet** -- Delete and refund balance
+
+### Teams
+- **DomiNode Create Team** -- Create team with shared wallet
+- **DomiNode List Teams** -- List user's teams
+- **DomiNode Team Details** -- Get team info
+- **DomiNode Team Fund** -- Fund team wallet
+- **DomiNode Team Create Key** -- Create team API key
+- **DomiNode Team Usage** -- Team transaction history
+- **DomiNode Update Team** -- Update team settings
+- **DomiNode Update Team Member Role** -- Change member role
+
+### Payments
+- **DomiNode X402 Info** -- x402 micropayment protocol details
+
+## Security
+
+All tools include:
+- SSRF prevention (private IP blocking, DNS rebinding protection, Teredo/6to4 IPv6 tunnel detection)
+- OFAC sanctioned country blocking (CU, IR, KP, RU, SY)
+- Credential scrubbing in error messages
+- Prototype pollution prevention
+- HTTP method restriction (GET/HEAD/OPTIONS only for proxied fetch)
+- 10 MB response cap, redirect following disabled
+
+## Testing
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_superagi-1.0.0/dominusnode_superagi/__init__.py

@@ -0,0 +1,5 @@
+"""DomiNode tools for SuperAGI agents."""
+from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+__version__ = "1.0.0"
+__all__ = ["DominusNodeToolkit"]

dominusnode_superagi-1.0.0/dominusnode_superagi/toolkit.py

@@ -0,0 +1,133 @@
+"""DomiNode SuperAGI Toolkit -- registers all 24 DomiNode tools.
+
+Provides a ``BaseToolkit`` subclass that exposes 24 tools for interacting
+with the DomiNode rotating proxy-as-a-service platform.  The toolkit
+covers proxied HTTP fetching, wallet and usage monitoring, agentic wallet
+management, team management, x402 micropayments, and PayPal top-up.
+
+Example::
+
+    from dominusnode_superagi.toolkit import DominusNodeToolkit
+
+    toolkit = DominusNodeToolkit()
+    tools = toolkit.get_tools()
+    # Each tool has .name, .description, .args_schema, and ._execute()
+
+Requires ``DOMINUSNODE_API_KEY`` (and optionally ``DOMINUSNODE_BASE_URL``,
+``DOMINUSNODE_PROXY_HOST``, ``DOMINUSNODE_PROXY_PORT``) to be set in
+SuperAGI's tool configuration.
+"""
+
+from __future__ import annotations
+
+from superagi.tools.base_tool import BaseToolkit
+
+from dominusnode_superagi.tools import (
+    DominusNodeAgenticTransactionsTool,
+    DominusNodeAgenticWalletBalanceTool,
+    DominusNodeBalanceTool,
+    DominusNodeCreateAgenticWalletTool,
+    DominusNodeCreateTeamTool,
+    DominusNodeDeleteAgenticWalletTool,
+    DominusNodeFreezeAgenticWalletTool,
+    DominusNodeFundAgenticWalletTool,
+    DominusNodeListAgenticWalletsTool,
+    DominusNodeListTeamsTool,
+    DominusNodeProxiedFetchTool,
+    DominusNodeProxyConfigTool,
+    DominusNodeSessionsTool,
+    DominusNodeTeamCreateKeyTool,
+    DominusNodeTeamDetailsTool,
+    DominusNodeTeamFundTool,
+    DominusNodeTeamUsageTool,
+    DominusNodeTopupPaypalTool,
+    DominusNodeUnfreezeAgenticWalletTool,
+    DominusNodeUpdateTeamMemberRoleTool,
+    DominusNodeUpdateTeamTool,
+    DominusNodeUpdateWalletPolicyTool,
+    DominusNodeUsageTool,
+    DominusNodeX402InfoTool,
+)
+
+
+class DominusNodeToolkit(BaseToolkit):
+    """SuperAGI toolkit providing 22 DomiNode proxy service tools.
+
+    Tools include:
+
+    **Proxy Operations:**
+      - Proxied Fetch -- fetch URLs through rotating proxies
+      - Proxy Config -- get proxy endpoint configuration
+      - List Sessions -- view active proxy sessions
+
+    **Wallet:**
+      - Check Balance -- view wallet balance
+      - Check Usage -- view usage statistics
+      - TopUp PayPal -- create a PayPal wallet top-up order
+
+    **Agentic Wallets:**
+      - Create, Fund, Balance, List, Transactions
+      - Freeze, Unfreeze, Delete
+
+    **Teams:**
+      - Create, List, Details, Fund, Create Key, Usage
+      - Update Team, Update Member Role
+
+    **Payments:**
+      - X402 Info -- micropayment protocol details
+    """
+
+    name: str = "DomiNode Proxy Toolkit"
+    description: str = (
+        "Rotating proxy-as-a-service with wallet billing, team management, "
+        "agentic sub-wallets, and x402 micropayments. Datacenter proxies at "
+        "$3/GB, residential at $5/GB."
+    )
+
+    def get_tools(self) -> list:
+        """Return all 24 DomiNode tools for registration in SuperAGI.
+
+        Returns:
+            A list of 22 BaseTool instances covering proxy, wallet, team,
+            and payment operations.
+        """
+        return [
+            DominusNodeProxiedFetchTool(),
+            DominusNodeBalanceTool(),
+            DominusNodeUsageTool(),
+            DominusNodeProxyConfigTool(),
+            DominusNodeSessionsTool(),
+            DominusNodeCreateAgenticWalletTool(),
+            DominusNodeFundAgenticWalletTool(),
+            DominusNodeAgenticWalletBalanceTool(),
+            DominusNodeListAgenticWalletsTool(),
+            DominusNodeAgenticTransactionsTool(),
+            DominusNodeFreezeAgenticWalletTool(),
+            DominusNodeUnfreezeAgenticWalletTool(),
+            DominusNodeDeleteAgenticWalletTool(),
+            DominusNodeUpdateWalletPolicyTool(),
+            DominusNodeCreateTeamTool(),
+            DominusNodeListTeamsTool(),
+            DominusNodeTeamDetailsTool(),
+            DominusNodeTeamFundTool(),
+            DominusNodeTeamCreateKeyTool(),
+            DominusNodeTeamUsageTool(),
+            DominusNodeUpdateTeamTool(),
+            DominusNodeUpdateTeamMemberRoleTool(),
+            DominusNodeX402InfoTool(),
+            DominusNodeTopupPaypalTool(),
+        ]
+
+    def get_env_keys(self) -> list:
+        """Return the environment/config keys needed by DomiNode tools.
+
+        Returns:
+            A list of configuration key names that SuperAGI should prompt
+            the user to set.
+        """
+        return [
+            "DOMINUSNODE_API_KEY",
+            "DOMINUSNODE_BASE_URL",
+            "DOMINUSNODE_PROXY_HOST",
+            "DOMINUSNODE_PROXY_PORT",
+        ]