n8n-nodes-dominusnode 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to `n8n-nodes-dominusnode` will be documented in this file.
+
+## [1.0.0] - 2025-02-23
+
+### Added
+- Initial release of n8n community nodes for DomiNode
+- **DomiNode Proxy** node: Proxied Fetch, Get Proxy Config, List Active Sessions
+- **DomiNode Wallet** node: 20 operations covering wallet, agentic wallets, and teams
+- **DomiNode Usage** node: Check usage statistics by period (day/week/month)
+- Full SSRF prevention (private IPs, hex/octal/decimal, IPv6, Teredo, 6to4, CGNAT, multicast)
+- DNS rebinding protection
+- OFAC sanctioned country blocking (CU, IR, KP, RU, SY)
+- Read-only HTTP methods for proxied fetch (GET, HEAD, OPTIONS)
+- Credential sanitization in all error messages
+- Prototype pollution prevention in JSON parsing
+- Support for 10 cryptocurrencies (BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB)
+- PayPal top-up support via Stripe
+- Agentic wallet CRUD with freeze/unfreeze/delete
+- Team management with CRUD, wallet funding, API keys, and member role updates

package/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.

package/README.md

@@ -0,0 +1,99 @@
+# n8n-nodes-dominusnode
+
+n8n community nodes for the [DomiNode](https://dominusnode.com) rotating proxy-as-a-service platform.
+
+## Installation
+
+### Community Node (Recommended)
+
+1. Go to **Settings** > **Community Nodes** in your n8n instance
+2. Enter `n8n-nodes-dominusnode`
+3. Click **Install**
+
+### Manual Installation
+
+```bash
+cd ~/.n8n/nodes
+npm install n8n-nodes-dominusnode
+```
+
+## Credentials
+
+Create a **DomiNode API** credential with:
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| API Key | Your DomiNode API key (`dn_live_...` or `dn_test_...`) | *(required)* |
+| Base URL | DomiNode API base URL | `https://api.dominusnode.com` |
+| Proxy Host | Proxy gateway hostname | `proxy.dominusnode.com` |
+| Proxy Port | Proxy gateway port | `8080` |
+
+## Nodes
+
+### DomiNode Proxy
+
+Make HTTP requests through DomiNode's rotating proxy network.
+
+**Operations:**
+- **Proxied Fetch** -- Route HTTP requests through datacenter or residential proxies with geo-targeting
+- **Get Proxy Config** -- Retrieve proxy endpoint configuration
+- **List Active Sessions** -- List currently active proxy sessions
+
+### DomiNode Wallet
+
+Manage your DomiNode wallet, agentic sub-wallets, and teams.
+
+**Operations:**
+- **Check Balance** -- Get current wallet balance
+- **Top Up (Stripe)** -- Create a Stripe checkout session
+- **Top Up (Crypto)** -- Create a crypto invoice (BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB)
+- **Top Up (PayPal)** -- Create a PayPal checkout session
+- **Create Agentic Wallet** -- Create a sub-wallet with spending limits for AI agents
+- **Fund Agentic Wallet** -- Transfer funds to an agentic wallet
+- **Get Agentic Wallet Balance** -- Check an agentic wallet's balance
+- **List Agentic Wallets** -- List all agentic wallets
+- **Get Agentic Transactions** -- Get transaction history
+- **Freeze/Unfreeze/Delete Agentic Wallet** -- Lifecycle management
+- **Create Team** -- Create a shared billing team
+- **List Teams** / **Team Details** -- View teams
+- **Fund Team** -- Fund a team wallet
+- **Create Team Key** -- Create team API keys
+- **Team Usage** -- View team transaction history
+- **Update Team** / **Update Team Member Role** -- Team administration
+
+### DomiNode Usage
+
+Check proxy usage statistics.
+
+**Operations:**
+- **Check Usage** -- Get bandwidth and cost statistics for a given period (day, week, month)
+
+## Security
+
+All nodes include comprehensive security measures:
+
+- **SSRF Prevention**: Blocks private IPs, localhost, cloud metadata endpoints, hex/octal/decimal-encoded IPs, IPv4-mapped/compatible IPv6, Teredo tunneling, 6to4, CGNAT, multicast, and internal TLDs (.localhost, .local, .internal, .arpa)
+- **DNS Rebinding Protection**: Resolves hostnames and validates all returned IPs before making proxy requests
+- **OFAC Compliance**: Blocks geo-targeting to sanctioned countries (Cuba, Iran, North Korea, Russia, Syria)
+- **Read-Only Methods**: Proxied fetch only allows GET, HEAD, and OPTIONS to prevent abuse
+- **Credential Sanitization**: API keys are redacted from all error messages
+- **Prototype Pollution Prevention**: All JSON responses are stripped of dangerous keys
+
+## Pricing
+
+| Pool Type | Price | Cost | Margin |
+|-----------|-------|------|--------|
+| Datacenter | $3/GB | $0.012/GB | 99.6% |
+| Residential | $5/GB | $4.00/GB | 20% |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/credentials/DominusNodeApi.credentials.d.ts

@@ -0,0 +1,7 @@
+import { ICredentialType, INodeProperties } from "n8n-workflow";
+export declare class DominusNodeApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+}

package/dist/credentials/DominusNodeApi.credentials.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DominusNodeApi = void 0;
+class DominusNodeApi {
+    name = "dominusNodeApi";
+    displayName = "DomiNode API";
+    documentationUrl = "https://docs.dominusnode.com";
+    properties = [
+        {
+            displayName: "API Key",
+            name: "apiKey",
+            type: "string",
+            typeOptions: { password: true },
+            default: "",
+            required: true,
+            description: 'DomiNode API key (starts with dn_live_ or dn_test_)',
+        },
+        {
+            displayName: "Base URL",
+            name: "baseUrl",
+            type: "string",
+            default: "https://api.dominusnode.com",
+            description: "DomiNode API base URL",
+        },
+        {
+            displayName: "Proxy Host",
+            name: "proxyHost",
+            type: "string",
+            default: "proxy.dominusnode.com",
+            description: "DomiNode proxy gateway hostname",
+        },
+        {
+            displayName: "Proxy Port",
+            name: "proxyPort",
+            type: "number",
+            default: 8080,
+            description: "DomiNode proxy gateway port",
+        },
+    ];
+}
+exports.DominusNodeApi = DominusNodeApi;
+//# sourceMappingURL=DominusNodeApi.credentials.js.map

package/dist/credentials/DominusNodeApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DominusNodeApi.credentials.js","sourceRoot":"","sources":["../../src/credentials/DominusNodeApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IACzB,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,cAAc,CAAC;IAC7B,gBAAgB,GAAG,8BAA8B,CAAC;IAClD,UAAU,GAAsB;QAC9B;YACE,WAAW,EAAE,SAAS;YACtB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC/B,OAAO,EAAE,EAAE;YACX,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,qDAAqD;SACnE;QACD;YACE,WAAW,EAAE,UAAU;YACvB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,6BAA6B;YACtC,WAAW,EAAE,uBAAuB;SACrC;QACD;YACE,WAAW,EAAE,YAAY;YACzB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,uBAAuB;YAChC,WAAW,EAAE,iCAAiC;SAC/C;QACD;YACE,WAAW,EAAE,YAAY;YACzB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,6BAA6B;SAC3C;KACF,CAAC;CACH;AApCD,wCAoCC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { DominusNodeApi } from "./credentials/DominusNodeApi.credentials";
+export { DominusNodeProxy } from "./nodes/DominusNodeProxy/DominusNodeProxy.node";
+export { DominusNodeWallet } from "./nodes/DominusNodeWallet/DominusNodeWallet.node";
+export { DominusNodeUsage } from "./nodes/DominusNodeUsage/DominusNodeUsage.node";

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DominusNodeUsage = exports.DominusNodeWallet = exports.DominusNodeProxy = exports.DominusNodeApi = void 0;
+var DominusNodeApi_credentials_1 = require("./credentials/DominusNodeApi.credentials");
+Object.defineProperty(exports, "DominusNodeApi", { enumerable: true, get: function () { return DominusNodeApi_credentials_1.DominusNodeApi; } });
+var DominusNodeProxy_node_1 = require("./nodes/DominusNodeProxy/DominusNodeProxy.node");
+Object.defineProperty(exports, "DominusNodeProxy", { enumerable: true, get: function () { return DominusNodeProxy_node_1.DominusNodeProxy; } });
+var DominusNodeWallet_node_1 = require("./nodes/DominusNodeWallet/DominusNodeWallet.node");
+Object.defineProperty(exports, "DominusNodeWallet", { enumerable: true, get: function () { return DominusNodeWallet_node_1.DominusNodeWallet; } });
+var DominusNodeUsage_node_1 = require("./nodes/DominusNodeUsage/DominusNodeUsage.node");
+Object.defineProperty(exports, "DominusNodeUsage", { enumerable: true, get: function () { return DominusNodeUsage_node_1.DominusNodeUsage; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uFAA0E;AAAjE,4HAAA,cAAc,OAAA;AACvB,wFAAkF;AAAzE,yHAAA,gBAAgB,OAAA;AACzB,2FAAqF;AAA5E,2HAAA,iBAAiB,OAAA;AAC1B,wFAAkF;AAAzE,yHAAA,gBAAgB,OAAA"}

package/dist/nodes/DominusNodeProxy/DominusNodeProxy.node.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DomiNode Proxy n8n community node.
+ *
+ * Operations:
+ * - Proxied Fetch: Make HTTP requests through DomiNode's rotating proxy network
+ * - Get Proxy Config: Retrieve proxy endpoint configuration
+ * - List Active Sessions: List currently active proxy sessions
+ *
+ * Security:
+ * - Full SSRF prevention (private IPs, hex/octal/decimal, IPv6 variants,
+ *   Teredo, 6to4, CGNAT, multicast, .localhost/.local/.internal/.arpa)
+ * - DNS rebinding protection
+ * - OFAC sanctioned country blocking
+ * - Read-only HTTP methods only (GET, HEAD, OPTIONS)
+ * - Credential sanitization in error messages
+ * - Prototype pollution prevention
+ *
+ * @module
+ */
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class DominusNodeProxy implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}