@dominusnode/openclaw-plugin 1.0.0 → 1.1.0

package/README.md

@@ -1,10 +1,10 @@
-# DomiNode OpenClaw Plugin
+# Dominus Node OpenClaw Plugin
 
-Route web requests through DomiNode's rotating proxy network directly from your OpenClaw AI coding sessions. Supports datacenter and residential proxy pools with geo-targeting across 195+ countries, agentic wallets for autonomous agent billing, and team collaboration with shared wallets.
+Route web requests through Dominus Node's rotating proxy network directly from your OpenClaw AI coding sessions. Supports datacenter and residential proxy pools with geo-targeting across 195+ countries, agentic wallets for autonomous agent billing, and team collaboration with shared wallets.
 
-## What is DomiNode?
+## What is Dominus Node?
 
-DomiNode is a rotating proxy-as-a-service (PaaS) platform. Users connect to DomiNode, are automatically assigned a proxy IP from a managed pool, and their traffic is routed through it. Usage is metered by bandwidth and billed via a prepaid wallet system.
+Dominus Node is a rotating proxy-as-a-service (PaaS) platform. Users connect to Dominus Node, are automatically assigned a proxy IP from a managed pool, and their traffic is routed through it. Usage is metered by bandwidth and billed via a prepaid wallet system.
 
 - **Datacenter proxies**: $3.00/GB (fastest, best for non-protected targets)
 - **Residential proxies**: $5.00/GB (premium, harder to detect)
@@ -28,9 +28,9 @@ export DOMINUSNODE_BASE_URL="https://api.dominusnode.com"  # optional, this is t
 ### Manual Setup
 
 ```bash
-# Clone the DomiNode repo
-git clone https://github.com/Dominus-Node/DomiNode.git
-cd DomiNode/integrations/openclaw
+# Clone the Dominus Node repo
+git clone https://github.com/Dominus-Node/Dominus Node.git
+cd Dominus Node/integrations/openclaw
 
 # No npm install needed — the plugin uses only native fetch (Node 18+)
 ```
@@ -39,8 +39,8 @@ cd DomiNode/integrations/openclaw
 
 | Environment Variable | Required | Default | Description |
 |---|---|---|---|
-| `DOMINUSNODE_API_KEY` | Yes | -- | Your DomiNode API key (starts with `dn_live_` or `dn_test_`) |
-| `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | Base URL for the DomiNode REST API |
+| `DOMINUSNODE_API_KEY` | Yes | -- | Your Dominus Node API key (starts with `dn_live_` or `dn_test_`) |
+| `DOMINUSNODE_BASE_URL` | No | `https://api.dominusnode.com` | Base URL for the Dominus Node REST API |
 
 ### Getting an API Key
 
@@ -176,7 +176,7 @@ Use proxied_fetch to get https://httpbin.org/ip through a US datacenter proxy
 
 ### Check your budget
 ```
-Check my DomiNode balance and tell me how much residential browsing I have left
+Check my Dominus Node balance and tell me how much residential browsing I have left
 ```
 
 ### Set up a research team
@@ -191,7 +191,7 @@ Create an agentic wallet called "price-monitor" with a $5 spending limit, fund i
 
 ### View usage breakdown
 ```
-Show my DomiNode usage for the last 7 days
+Show my Dominus Node usage for the last 7 days
 ```
 
 ### Fetch with residential proxy and geo-targeting
@@ -241,7 +241,7 @@ The plugin implements comprehensive security measures:
 
 - Node.js 18+ (uses native `fetch`)
 - OpenClaw runtime with `jiti` support
-- DomiNode API key with funded wallet
+- Dominus Node API key with funded wallet
 
 ## License
 

package/dist/plugin.d.ts

@@ -1,7 +1,7 @@
 /**
- * DomiNode OpenClaw Plugin
+ * Dominus Node OpenClaw Plugin
  *
- * Implements 24 tools for interacting with DomiNode's rotating proxy service
+ * Implements 26 tools for interacting with Dominus Node's rotating proxy service
  * directly from OpenClaw AI coding sessions.
  *
  * Uses native fetch (no external dependencies). Runs via jiti runtime.

package/dist/plugin.js

@@ -1,7 +1,7 @@
 /**
- * DomiNode OpenClaw Plugin
+ * Dominus Node OpenClaw Plugin
  *
- * Implements 24 tools for interacting with DomiNode's rotating proxy service
+ * Implements 26 tools for interacting with Dominus Node's rotating proxy service
  * directly from OpenClaw AI coding sessions.
  *
  * Uses native fetch (no external dependencies). Runs via jiti runtime.
@@ -36,7 +36,7 @@ function getApiKey() {
     const key = process.env.DOMINUSNODE_API_KEY;
     if (!key || typeof key !== "string" || key.trim().length === 0) {
         throw new Error("DOMINUSNODE_API_KEY environment variable is required. " +
-            'Set it to your DomiNode API key (starts with "dn_live_" or "dn_test_").');
+            'Set it to your Dominus Node API key (starts with "dn_live_" or "dn_test_").');
     }
     const trimmed = key.trim();
     if (!trimmed.startsWith("dn_live_") && !trimmed.startsWith("dn_test_")) {
@@ -61,6 +61,9 @@ function getProxyPort() {
         return 8080;
     return port;
 }
+function getAgentSecret() {
+    return process.env.DOMINUSNODE_AGENT_SECRET || undefined;
+}
 // ---------------------------------------------------------------------------
 // Credential scrubbing
 // ---------------------------------------------------------------------------
@@ -351,9 +354,18 @@ async function ensureAuth(apiKey, baseUrl) {
     const keyPrefix = apiKey.slice(0, 16);
     if (cachedJwt && Date.now() < jwtExpiresAt && cachedApiKeyPrefix === keyPrefix)
         return cachedJwt;
+    const authHeaders = {
+        "Content-Type": "application/json",
+        "User-Agent": "dominusnode-openclaw-plugin/1.0.0",
+    };
+    const agentSecret = getAgentSecret();
+    if (agentSecret) {
+        authHeaders["X-DominusNode-Agent"] = "mcp";
+        authHeaders["X-DominusNode-Agent-Secret"] = agentSecret;
+    }
     const res = await fetch(`${baseUrl}/api/auth/verify-key`, {
         method: "POST",
-        headers: { "Content-Type": "application/json", "User-Agent": "dominusnode-openclaw-plugin/1.0.0" },
+        headers: authHeaders,
         body: JSON.stringify({ apiKey }),
         redirect: "error",
     });
@@ -378,6 +390,11 @@ async function apiRequest(method, path, body) {
         "Accept": "application/json",
         "User-Agent": "dominusnode-openclaw-plugin/1.0.0",
     };
+    const agentSecret = getAgentSecret();
+    if (agentSecret) {
+        headers["X-DominusNode-Agent"] = "mcp";
+        headers["X-DominusNode-Agent-Secret"] = agentSecret;
+    }
     const init = {
         method,
         headers,
@@ -470,7 +487,7 @@ function formatCents(cents) {
 // 1. proxied_fetch
 const proxiedFetchTool = {
     name: "proxied_fetch",
-    description: "Fetch a URL through DomiNode's rotating proxy network. Supports geo-targeting " +
+    description: "Fetch a URL through Dominus Node's rotating proxy network. Supports geo-targeting " +
         "by country. Returns status code, headers, and response body (truncated to 4000 chars).",
     parameters: {
         url: {
@@ -660,7 +677,7 @@ const proxiedFetchTool = {
 // 2. check_balance
 const checkBalanceTool = {
     name: "check_balance",
-    description: "Check your DomiNode wallet balance and estimated remaining bandwidth at current pricing.",
+    description: "Check your Dominus Node wallet balance and estimated remaining bandwidth at current pricing.",
     parameters: {},
     execute: async () => {
         try {
@@ -726,7 +743,7 @@ const getProxyConfigTool = {
         try {
             const data = await apiGet("/api/proxy/config");
             const lines = [
-                "DomiNode Proxy Configuration",
+                "Dominus Node Proxy Configuration",
                 "",
                 `Proxy Host: ${data.proxyHost ?? "proxy.dominusnode.com"}`,
                 `HTTP Proxy Port: ${data.httpProxyPort ?? 8080}`,
@@ -1422,7 +1439,7 @@ const updateTeamTool = {
 // 21. topup_paypal
 const topupPaypalTool = {
     name: "topup_paypal",
-    description: "Top up your DomiNode wallet balance via PayPal. Creates a PayPal order and returns an " +
+    description: "Top up your Dominus Node wallet balance via PayPal. Creates a PayPal order and returns an " +
         "approval URL to complete payment. Minimum $5 (500 cents), maximum $1,000 (100000 cents).",
     parameters: {
         amount_cents: {
@@ -1454,7 +1471,92 @@ const topupPaypalTool = {
         }
     },
 };
-// 22. x402_info
+// 22. topup_stripe
+const topupStripeTool = {
+    name: "topup_stripe",
+    description: "Top up your Dominus Node wallet balance via Stripe. Creates a Stripe checkout session and returns " +
+        "a checkout URL to complete payment. Minimum $5 (500 cents), maximum $1,000 (100000 cents).",
+    parameters: {
+        amount_cents: {
+            type: "number",
+            description: "Amount in cents to top up (min 500 = $5, max 100000 = $1,000)",
+            required: true,
+        },
+    },
+    execute: async (args) => {
+        try {
+            const amountCents = Number(args.amount_cents ?? 0);
+            if (!Number.isInteger(amountCents) || amountCents < 500 || amountCents > 100000) {
+                return "Error: amount_cents must be an integer between 500 ($5) and 100000 ($1,000).";
+            }
+            const data = await apiPost("/api/wallet/topup/stripe", { amountCents });
+            return [
+                "Stripe Checkout Session Created",
+                "",
+                `Session ID: ${data.sessionId}`,
+                `Amount: ${formatCents(amountCents)}`,
+                `Checkout URL: ${data.url}`,
+                "",
+                "Open the checkout URL in a browser to complete payment.",
+                "Once paid, the funds will be credited to your wallet automatically.",
+            ].join("\n");
+        }
+        catch (err) {
+            return `Error: ${safeError(err)}`;
+        }
+    },
+};
+// 23. topup_crypto
+const VALID_CRYPTO_CURRENCIES = new Set([
+    "BTC", "ETH", "LTC", "XMR", "ZEC", "USDC", "SOL", "USDT", "DAI", "BNB", "LINK",
+]);
+const topupCryptoTool = {
+    name: "topup_crypto",
+    description: "Top up your Dominus Node wallet balance via cryptocurrency. Creates a crypto payment invoice " +
+        "and returns payment details. Minimum $5, maximum $1,000. " +
+        "Supported currencies: BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, LINK.",
+    parameters: {
+        amount_usd: {
+            type: "number",
+            description: "Amount in USD to top up (min 5, max 1000)",
+            required: true,
+        },
+        currency: {
+            type: "string",
+            description: "Cryptocurrency to pay with",
+            required: true,
+            enum: ["BTC", "ETH", "LTC", "XMR", "ZEC", "USDC", "SOL", "USDT", "DAI", "BNB", "LINK"],
+        },
+    },
+    execute: async (args) => {
+        try {
+            const amountUsd = Number(args.amount_usd ?? 0);
+            if (typeof amountUsd !== "number" || !Number.isFinite(amountUsd) || amountUsd < 5 || amountUsd > 1000) {
+                return "Error: amount_usd must be a number between 5 and 1000.";
+            }
+            const currency = String(args.currency ?? "").toUpperCase();
+            if (!VALID_CRYPTO_CURRENCIES.has(currency)) {
+                return `Error: currency must be one of: ${[...VALID_CRYPTO_CURRENCIES].join(", ")}.`;
+            }
+            const data = await apiPost("/api/wallet/topup/crypto", { amountUsd, currency: currency.toLowerCase() });
+            return [
+                "Crypto Payment Invoice Created",
+                "",
+                `Invoice ID: ${data.invoiceId}`,
+                `Amount: $${amountUsd}`,
+                `Pay: ${data.priceAmount} ${data.payCurrency?.toUpperCase() ?? currency}`,
+                `Payment URL: ${data.invoiceUrl}`,
+                "",
+                "Open the payment URL to complete payment.",
+                "Once confirmed on-chain, the funds will be credited to your wallet.",
+            ].join("\n");
+        }
+        catch (err) {
+            return `Error: ${safeError(err)}`;
+        }
+    },
+};
+// 24. x402_info
 const x402InfoTool = {
     name: "x402_info",
     description: "Get x402 micropayment protocol information including supported " +
@@ -1470,7 +1572,7 @@ const x402InfoTool = {
         }
     },
 };
-// 23. update_team_member_role
+// 25. update_team_member_role
 const updateTeamMemberRoleTool = {
     name: "update_team_member_role",
     description: "Update a team member's role (member or admin). Only owners and admins can change roles.",
@@ -1516,7 +1618,7 @@ const updateTeamMemberRoleTool = {
         }
     },
 };
-// 24. update_wallet_policy
+// 26. update_wallet_policy
 const updateWalletPolicyTool = {
     name: "update_wallet_policy",
     description: "Update the policy of an agentic wallet. Sets or clears the daily budget cap " +
@@ -1623,6 +1725,8 @@ export const tools = [
     updateTeamTool,
     updateTeamMemberRoleTool,
     topupPaypalTool,
+    topupStripeTool,
+    topupCryptoTool,
     x402InfoTool,
     updateWalletPolicyTool,
 ];
@@ -1632,7 +1736,7 @@ export const tools = [
 export const plugin = {
     name: "dominusnode-proxy",
     version: "1.0.0",
-    description: "Route web requests through DomiNode's rotating proxy network with geo-targeting, " +
+    description: "Route web requests through Dominus Node's rotating proxy network with geo-targeting, " +
         "balance management, agentic wallets, and team collaboration.",
     tools,
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dominusnode/openclaw-plugin",
-  "version": "1.0.0",
-  "description": "DomiNode proxy plugin for OpenClaw — route web requests through rotating proxy networks",
+  "version": "1.1.0",
+  "description": "Dominus Node proxy plugin for OpenClaw — route web requests through rotating proxy networks",
   "main": "dist/plugin.js",
   "types": "dist/plugin.d.ts",
   "type": "module",