dominusnode-dify 1.0.0__tar.gz

dominusnode_dify-1.0.0/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_dify-1.0.0/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.1
+Name: dominusnode-dify
+Version: 1.0.0
+Summary: DomiNode tool provider for Dify -- 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
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+
+# dominusnode-dify
+
+Dify tool provider for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform. Provides 22 tools for proxy management, wallet operations, team administration, and payment processing.
+
+## Installation
+
+```bash
+pip install dominusnode-dify
+```
+
+Or install from source:
+
+```bash
+cd integrations/dify
+pip install -e ".[dev]"
+```
+
+## Dify Plugin Structure
+
+This integration follows the Dify tool provider convention:
+
+```
+integrations/dify/
+  provider/dominusnode.yaml     # Provider definition (credentials)
+  tools/*.yaml                  # 22 tool YAML definitions
+  dominusnode_dify/tools.py     # Python implementation
+```
+
+### Provider Credentials
+
+The provider YAML (`provider/dominusnode.yaml`) defines three credentials:
+
+| Credential | Type | Required | Default |
+|-----------|------|----------|---------|
+| `api_key` | secret-input | Yes | - |
+| `base_url` | text-input | No | `https://api.dominusnode.com` |
+| `proxy_host` | text-input | No | `proxy.dominusnode.com` |
+
+### Environment Variables
+
+Alternatively, set environment variables:
+
+```bash
+export DOMINUSNODE_API_KEY="dn_live_your_api_key_here"
+export DOMINUSNODE_BASE_URL="https://api.dominusnode.com"
+export DOMINUSNODE_PROXY_HOST="proxy.dominusnode.com"
+export DOMINUSNODE_PROXY_PORT="8080"
+```
+
+## Quick Start (Python API)
+
+```python
+from dominusnode_dify import DominusNodeProvider
+
+# Create provider with Dify-style credentials dict
+provider = DominusNodeProvider(credentials={
+    "api_key": "dn_live_...",
+    "base_url": "https://api.dominusnode.com",
+    "proxy_host": "proxy.dominusnode.com",
+})
+
+# Check wallet balance
+result = provider.check_balance({})
+print(result)  # {"balanceCents": 5000}
+
+# Fetch a URL through rotating proxies
+result = provider.proxied_fetch({
+    "url": "https://example.com",
+    "country": "US",
+    "proxy_type": "dc",
+})
+
+# Use the tool dispatcher (how Dify invokes tools)
+result = provider.invoke_tool("check_balance", {})
+result = provider.invoke_tool("proxied_fetch", {"url": "https://example.com"})
+```
+
+## Tools (22 total)
+
+### Proxy Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `proxied_fetch` | Fetch URL through rotating proxy | `url` |
+| `get_proxy_config` | Get proxy configuration | - |
+| `list_sessions` | List active proxy sessions | - |
+
+### Wallet Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `check_balance` | Check wallet balance | - |
+| `check_usage` | Check usage statistics | - |
+| `topup_paypal` | Create PayPal top-up order | `amount_cents` |
+| `x402_info` | Get x402 micropayment info | - |
+
+### Agentic Wallet Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_agentic_wallet` | Create sub-wallet with spending limit | `label`, `spending_limit_cents` |
+| `fund_agentic_wallet` | Fund agentic wallet from main wallet | `wallet_id`, `amount_cents` |
+| `agentic_wallet_balance` | Check agentic wallet balance | `wallet_id` |
+| `list_agentic_wallets` | List all agentic wallets | - |
+| `agentic_transactions` | Get agentic wallet transactions | `wallet_id` |
+| `freeze_agentic_wallet` | Freeze agentic wallet | `wallet_id` |
+| `unfreeze_agentic_wallet` | Unfreeze agentic wallet | `wallet_id` |
+| `delete_agentic_wallet` | Delete agentic wallet | `wallet_id` |
+
+### Team Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_team` | Create team with shared wallet | `name` |
+| `list_teams` | List all teams | - |
+| `team_details` | Get team details | `team_id` |
+| `team_fund` | Fund team wallet | `team_id`, `amount_cents` |
+| `team_create_key` | Create team API key | `team_id`, `label` |
+| `team_usage` | Get team usage history | `team_id` |
+| `update_team` | Update team settings | `team_id` |
+| `update_team_member_role` | Change member role | `team_id`, `user_id`, `role` |
+
+## Usage Examples
+
+### Proxied Fetch with Geo-Targeting
+
+```python
+# Fetch through a US datacenter proxy ($3/GB)
+result = provider.proxied_fetch({
+    "url": "https://example.com",
+    "country": "US",
+    "proxy_type": "dc",
+})
+
+# Fetch through a German residential proxy ($5/GB)
+result = provider.proxied_fetch({
+    "url": "https://example.de",
+    "country": "DE",
+    "proxy_type": "residential",
+})
+```
+
+### Agentic Wallet Management
+
+```python
+# Create a sub-wallet for an AI agent with $10 spending limit
+wallet = provider.create_agentic_wallet({
+    "label": "Research Agent",
+    "spending_limit_cents": 1000,
+})
+
+# Fund it with $5 from main wallet
+provider.fund_agentic_wallet({
+    "wallet_id": wallet["id"],
+    "amount_cents": 500,
+})
+
+# Check balance
+print(provider.agentic_wallet_balance({"wallet_id": wallet["id"]}))
+
+# Freeze if needed
+provider.freeze_agentic_wallet({"wallet_id": wallet["id"]})
+```
+
+### Team Management
+
+```python
+# Create a team
+team = provider.create_team({"name": "Research Team", "max_members": 10})
+
+# Fund the team wallet
+provider.team_fund({
+    "team_id": team["id"],
+    "amount_cents": 5000,
+})
+
+# Create a team API key
+key = provider.team_create_key({
+    "team_id": team["id"],
+    "label": "Agent Key",
+})
+```
+
+### Dify Tool Dispatch
+
+```python
+# The invoke_tool method is designed for Dify's tool invocation system
+result = provider.invoke_tool("proxied_fetch", {
+    "url": "https://example.com",
+    "country": "GB",
+    "proxy_type": "residential",
+})
+
+result = provider.invoke_tool("create_team", {
+    "name": "My Team",
+    "max_members": 5,
+})
+
+# List all available tools
+tools = DominusNodeProvider.get_tools()
+for tool in tools:
+    print(tool)
+```
+
+## Security
+
+This integration includes comprehensive security measures:
+
+- **SSRF Prevention**: Blocks requests to private IPs (10.x, 172.16-31.x, 192.168.x, 127.x, 0.0.0.0/8, 169.254.x, 100.64-127.x CGNAT, 224+ multicast), IPv6 loopback/ULA/link-local, IPv4-mapped/compatible IPv6, Teredo (2001:0000::/32), 6to4 (2002::/16), hex/octal/decimal encoded IPs
+- **DNS Rebinding Protection**: Resolves hostnames and validates all IP addresses before connecting
+- **TLD Blocking**: .localhost, .local, .internal, .arpa
+- **Credential Protection**: Embedded URL credentials blocked; API keys scrubbed from all error output
+- **OFAC Compliance**: Cuba, Iran, North Korea, Russia, Syria blocked for geo-targeting
+- **HTTP Method Restriction**: Only GET, HEAD, OPTIONS allowed through proxy
+- **Prototype Pollution Prevention**: Dangerous keys stripped from all JSON responses
+- **Response Limits**: 10 MB body cap, 4000 char truncation for LLM context
+- **Redirect Disabled**: No redirect following to prevent open redirect abuse
+
+## Running Tests
+
+```bash
+cd integrations/dify
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_dify-1.0.0/README.md

@@ -0,0 +1,229 @@
+# dominusnode-dify
+
+Dify tool provider for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform. Provides 22 tools for proxy management, wallet operations, team administration, and payment processing.
+
+## Installation
+
+```bash
+pip install dominusnode-dify
+```
+
+Or install from source:
+
+```bash
+cd integrations/dify
+pip install -e ".[dev]"
+```
+
+## Dify Plugin Structure
+
+This integration follows the Dify tool provider convention:
+
+```
+integrations/dify/
+  provider/dominusnode.yaml     # Provider definition (credentials)
+  tools/*.yaml                  # 22 tool YAML definitions
+  dominusnode_dify/tools.py     # Python implementation
+```
+
+### Provider Credentials
+
+The provider YAML (`provider/dominusnode.yaml`) defines three credentials:
+
+| Credential | Type | Required | Default |
+|-----------|------|----------|---------|
+| `api_key` | secret-input | Yes | - |
+| `base_url` | text-input | No | `https://api.dominusnode.com` |
+| `proxy_host` | text-input | No | `proxy.dominusnode.com` |
+
+### Environment Variables
+
+Alternatively, set environment variables:
+
+```bash
+export DOMINUSNODE_API_KEY="dn_live_your_api_key_here"
+export DOMINUSNODE_BASE_URL="https://api.dominusnode.com"
+export DOMINUSNODE_PROXY_HOST="proxy.dominusnode.com"
+export DOMINUSNODE_PROXY_PORT="8080"
+```
+
+## Quick Start (Python API)
+
+```python
+from dominusnode_dify import DominusNodeProvider
+
+# Create provider with Dify-style credentials dict
+provider = DominusNodeProvider(credentials={
+    "api_key": "dn_live_...",
+    "base_url": "https://api.dominusnode.com",
+    "proxy_host": "proxy.dominusnode.com",
+})
+
+# Check wallet balance
+result = provider.check_balance({})
+print(result)  # {"balanceCents": 5000}
+
+# Fetch a URL through rotating proxies
+result = provider.proxied_fetch({
+    "url": "https://example.com",
+    "country": "US",
+    "proxy_type": "dc",
+})
+
+# Use the tool dispatcher (how Dify invokes tools)
+result = provider.invoke_tool("check_balance", {})
+result = provider.invoke_tool("proxied_fetch", {"url": "https://example.com"})
+```
+
+## Tools (22 total)
+
+### Proxy Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `proxied_fetch` | Fetch URL through rotating proxy | `url` |
+| `get_proxy_config` | Get proxy configuration | - |
+| `list_sessions` | List active proxy sessions | - |
+
+### Wallet Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `check_balance` | Check wallet balance | - |
+| `check_usage` | Check usage statistics | - |
+| `topup_paypal` | Create PayPal top-up order | `amount_cents` |
+| `x402_info` | Get x402 micropayment info | - |
+
+### Agentic Wallet Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_agentic_wallet` | Create sub-wallet with spending limit | `label`, `spending_limit_cents` |
+| `fund_agentic_wallet` | Fund agentic wallet from main wallet | `wallet_id`, `amount_cents` |
+| `agentic_wallet_balance` | Check agentic wallet balance | `wallet_id` |
+| `list_agentic_wallets` | List all agentic wallets | - |
+| `agentic_transactions` | Get agentic wallet transactions | `wallet_id` |
+| `freeze_agentic_wallet` | Freeze agentic wallet | `wallet_id` |
+| `unfreeze_agentic_wallet` | Unfreeze agentic wallet | `wallet_id` |
+| `delete_agentic_wallet` | Delete agentic wallet | `wallet_id` |
+
+### Team Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_team` | Create team with shared wallet | `name` |
+| `list_teams` | List all teams | - |
+| `team_details` | Get team details | `team_id` |
+| `team_fund` | Fund team wallet | `team_id`, `amount_cents` |
+| `team_create_key` | Create team API key | `team_id`, `label` |
+| `team_usage` | Get team usage history | `team_id` |
+| `update_team` | Update team settings | `team_id` |
+| `update_team_member_role` | Change member role | `team_id`, `user_id`, `role` |
+
+## Usage Examples
+
+### Proxied Fetch with Geo-Targeting
+
+```python
+# Fetch through a US datacenter proxy ($3/GB)
+result = provider.proxied_fetch({
+    "url": "https://example.com",
+    "country": "US",
+    "proxy_type": "dc",
+})
+
+# Fetch through a German residential proxy ($5/GB)
+result = provider.proxied_fetch({
+    "url": "https://example.de",
+    "country": "DE",
+    "proxy_type": "residential",
+})
+```
+
+### Agentic Wallet Management
+
+```python
+# Create a sub-wallet for an AI agent with $10 spending limit
+wallet = provider.create_agentic_wallet({
+    "label": "Research Agent",
+    "spending_limit_cents": 1000,
+})
+
+# Fund it with $5 from main wallet
+provider.fund_agentic_wallet({
+    "wallet_id": wallet["id"],
+    "amount_cents": 500,
+})
+
+# Check balance
+print(provider.agentic_wallet_balance({"wallet_id": wallet["id"]}))
+
+# Freeze if needed
+provider.freeze_agentic_wallet({"wallet_id": wallet["id"]})
+```
+
+### Team Management
+
+```python
+# Create a team
+team = provider.create_team({"name": "Research Team", "max_members": 10})
+
+# Fund the team wallet
+provider.team_fund({
+    "team_id": team["id"],
+    "amount_cents": 5000,
+})
+
+# Create a team API key
+key = provider.team_create_key({
+    "team_id": team["id"],
+    "label": "Agent Key",
+})
+```
+
+### Dify Tool Dispatch
+
+```python
+# The invoke_tool method is designed for Dify's tool invocation system
+result = provider.invoke_tool("proxied_fetch", {
+    "url": "https://example.com",
+    "country": "GB",
+    "proxy_type": "residential",
+})
+
+result = provider.invoke_tool("create_team", {
+    "name": "My Team",
+    "max_members": 5,
+})
+
+# List all available tools
+tools = DominusNodeProvider.get_tools()
+for tool in tools:
+    print(tool)
+```
+
+## Security
+
+This integration includes comprehensive security measures:
+
+- **SSRF Prevention**: Blocks requests to private IPs (10.x, 172.16-31.x, 192.168.x, 127.x, 0.0.0.0/8, 169.254.x, 100.64-127.x CGNAT, 224+ multicast), IPv6 loopback/ULA/link-local, IPv4-mapped/compatible IPv6, Teredo (2001:0000::/32), 6to4 (2002::/16), hex/octal/decimal encoded IPs
+- **DNS Rebinding Protection**: Resolves hostnames and validates all IP addresses before connecting
+- **TLD Blocking**: .localhost, .local, .internal, .arpa
+- **Credential Protection**: Embedded URL credentials blocked; API keys scrubbed from all error output
+- **OFAC Compliance**: Cuba, Iran, North Korea, Russia, Syria blocked for geo-targeting
+- **HTTP Method Restriction**: Only GET, HEAD, OPTIONS allowed through proxy
+- **Prototype Pollution Prevention**: Dangerous keys stripped from all JSON responses
+- **Response Limits**: 10 MB body cap, 4000 char truncation for LLM context
+- **Redirect Disabled**: No redirect following to prevent open redirect abuse
+
+## Running Tests
+
+```bash
+cd integrations/dify
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

dominusnode_dify-1.0.0/dominusnode_dify/__init__.py

@@ -0,0 +1,64 @@
+"""DomiNode Dify integration -- 24 tools for the Dify AI platform.
+
+Provides a Dify-compatible tool provider that exposes 24 tools for
+interacting with the DomiNode rotating proxy-as-a-service platform.
+
+Tools cover:
+  - Proxied HTTP fetching through rotating proxies
+  - Wallet balance and usage monitoring
+  - Proxy configuration and session listing
+  - Agentic wallet management (create, fund, freeze, unfreeze, delete)
+  - Team management (create, list, fund, keys, usage, update, role changes)
+  - x402 micropayment info
+  - PayPal top-up
+
+Security:
+  - Full SSRF prevention (private IP blocking, DNS rebinding, Teredo/6to4,
+    IPv4-mapped/compatible IPv6, hex/octal/decimal normalization, zone ID
+    stripping, .localhost/.local/.internal/.arpa TLD blocking, embedded
+    credential blocking)
+  - OFAC sanctioned country validation (CU, IR, KP, RU, SY)
+  - Credential scrubbing in all error outputs
+  - Prototype pollution prevention on all parsed JSON
+  - HTTP method restriction (GET/HEAD/OPTIONS only for proxied fetch)
+  - 10 MB response cap, 4000 char truncation, 30 s timeout
+  - Redirect following disabled to prevent open redirect abuse
+
+Requires: httpx (``pip install httpx``)
+"""
+
+from __future__ import annotations
+
+__version__ = "1.0.0"
+
+from dominusnode_dify.tools import (
+    BLOCKED_HOSTNAMES,
+    SANCTIONED_COUNTRIES,
+    DominusNodeProvider,
+    _extract_6to4_ipv4,
+    _extract_teredo_ipv4,
+    _is_private_ip,
+    _normalize_ipv4,
+    _sanitize_error,
+    _strip_dangerous_keys,
+    _validate_label,
+    _validate_positive_int,
+    _validate_uuid,
+    validate_url,
+)
+
+__all__ = [
+    "DominusNodeProvider",
+    "BLOCKED_HOSTNAMES",
+    "SANCTIONED_COUNTRIES",
+    "_is_private_ip",
+    "_normalize_ipv4",
+    "_extract_teredo_ipv4",
+    "_extract_6to4_ipv4",
+    "_sanitize_error",
+    "_strip_dangerous_keys",
+    "_validate_label",
+    "_validate_positive_int",
+    "_validate_uuid",
+    "validate_url",
+]