@dominusnode/openai-functions 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
-# DomiNode OpenAI-Compatible Function Calling Schemas
+# Dominus Node OpenAI-Compatible Function Calling Schemas
 
-OpenAI function-calling schemas and handler implementations for the DomiNode rotating proxy-as-a-service platform. These schemas allow any LLM with function/tool calling support to interact with DomiNode's proxy network, wallet, and agentic wallet APIs.
+OpenAI function-calling schemas and handler implementations for the Dominus Node rotating proxy-as-a-service platform. These schemas allow any LLM with function/tool calling support to interact with Dominus Node's proxy network, wallet, and agentic wallet APIs.
 
 ## What This Is
 
@@ -9,8 +9,8 @@ This directory contains:
 | File | Description |
 |------|-------------|
 | `functions.json` | Array of 8 OpenAI function definitions (JSON Schema format) |
-| `handler.ts` | TypeScript handler that dispatches function calls to the DomiNode API |
-| `handler.py` | Python handler that dispatches function calls to the DomiNode API |
+| `handler.ts` | TypeScript handler that dispatches function calls to the Dominus Node API |
+| `handler.py` | Python handler that dispatches function calls to the Dominus Node API |
 
 The function schemas follow the [OpenAI function calling specification](https://platform.openai.com/docs/guides/function-calling), which has become a de facto standard adopted by Claude (tool_use), Gemini, Mistral, Llama, and others.
 
@@ -18,7 +18,7 @@ The function schemas follow the [OpenAI function calling specification](https://
 
 | Function | Description | Auth Required |
 |----------|-------------|---------------|
-| `dominusnode_proxied_fetch` | Make an HTTP request through DomiNode's rotating proxy network | Yes |
+| `dominusnode_proxied_fetch` | Make an HTTP request through Dominus Node's rotating proxy network | Yes |
 | `dominusnode_check_balance` | Check wallet balance (cents, USD, currency) | Yes |
 | `dominusnode_check_usage` | Check usage stats for a time period (day/week/month) | Yes |
 | `dominusnode_get_proxy_config` | Get proxy endpoints, supported countries, geo-targeting info | Yes |
@@ -38,7 +38,7 @@ from handler import create_dominusnode_function_handler
 with open("functions.json") as f:
     functions = json.load(f)
 
-# Create the DomiNode handler
+# Create the Dominus Node handler
 dominusnode = create_dominusnode_function_handler(
     api_key="dn_live_your_api_key_here",
     base_url="https://api.dominusnode.com",
@@ -49,7 +49,7 @@ client = openai.OpenAI()
 response = client.chat.completions.create(
     model="gpt-4o",
     messages=[
-        {"role": "system", "content": "You have access to DomiNode proxy tools."},
+        {"role": "system", "content": "You have access to Dominus Node proxy tools."},
         {"role": "user", "content": "What is my current proxy balance?"},
     ],
     functions=functions,
@@ -62,14 +62,14 @@ if message.function_call:
     name = message.function_call.name
     args = json.loads(message.function_call.arguments)
 
-    # Dispatch to DomiNode handler
+    # Dispatch to Dominus Node handler
     result = await dominusnode(name, args)
 
     # Send the result back to the LLM
     response = client.chat.completions.create(
         model="gpt-4o",
         messages=[
-            {"role": "system", "content": "You have access to DomiNode proxy tools."},
+            {"role": "system", "content": "You have access to Dominus Node proxy tools."},
             {"role": "user", "content": "What is my current proxy balance?"},
             message,
             {"role": "function", "name": name, "content": result},
@@ -100,7 +100,7 @@ tools = [
     for fn in functions
 ]
 
-# Create the DomiNode handler
+# Create the Dominus Node handler
 dominusnode = create_dominusnode_function_handler(
     api_key="dn_live_your_api_key_here",
 )
@@ -112,7 +112,7 @@ response = client.messages.create(
     max_tokens=1024,
     tools=tools,
     messages=[
-        {"role": "user", "content": "Check my DomiNode proxy balance and usage this week."},
+        {"role": "user", "content": "Check my Dominus Node proxy balance and usage this week."},
     ],
 )
 
@@ -127,7 +127,7 @@ for block in response.content:
             max_tokens=1024,
             tools=tools,
             messages=[
-                {"role": "user", "content": "Check my DomiNode proxy balance and usage this week."},
+                {"role": "user", "content": "Check my Dominus Node proxy balance and usage this week."},
                 {"role": "assistant", "content": response.content},
                 {
                     "role": "user",
@@ -204,7 +204,7 @@ The `functions.json` file follows the standard OpenAI function definition schema
 | **OpenAI SDK** | Pass `functions` directly to `chat.completions.create()` |
 | **Anthropic SDK** | Convert to `tools` format (rename `parameters` to `input_schema`) |
 | **Google Gemini** | Convert to `FunctionDeclaration` objects |
-| **LangChain** | Use `StructuredTool.from_function()` or the DomiNode LangChain integration |
+| **LangChain** | Use `StructuredTool.from_function()` or the Dominus Node LangChain integration |
 | **Vercel AI SDK** | See the `integrations/vercel-ai/` package |
 | **LlamaIndex** | Use `FunctionTool.from_defaults()` with the handler |
 | **Ollama** | Pass as `tools` parameter in chat API |

package/dist/handler.d.ts

@@ -1,8 +1,8 @@
 /**
- * DomiNode OpenAI-compatible function calling handler (TypeScript).
+ * Dominus Node OpenAI-compatible function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * OpenAI function calls to the DomiNode REST API. Works with any
+ * OpenAI function calls to the Dominus Node REST API. Works with any
  * function-calling LLM system: OpenAI GPT, Anthropic Claude tool_use,
  * Google Gemini, or custom implementations.
  *
@@ -40,23 +40,25 @@ declare function stripDangerousKeys(obj: unknown, depth?: number): void;
 declare function safeJsonParse<T>(text: string): T;
 declare function sanitizeError(message: string): string;
 export interface DominusNodeFunctionConfig {
-    /** DomiNode API key (starts with dn_live_ or dn_test_). */
+    /** Dominus Node API key (starts with dn_live_ or dn_test_). */
     apiKey: string;
-    /** Base URL of the DomiNode REST API. Defaults to https://api.dominusnode.com */
+    /** Base URL of the Dominus Node REST API. Defaults to https://api.dominusnode.com */
     baseUrl?: string;
     /** Request timeout in milliseconds. Defaults to 30000. */
     timeoutMs?: number;
+    /** Agent secret for MCP agent identification. Bypasses reCAPTCHA and auto-verifies email. */
+    agentSecret?: string;
 }
 /**
  * Handler function type returned by createDominusNodeFunctionHandler.
- * Dispatches function calls to the DomiNode API and returns JSON string results.
+ * Dispatches function calls to the Dominus Node API and returns JSON string results.
  */
 export type FunctionHandler = (name: string, args: Record<string, unknown>) => Promise<string>;
 /**
- * Create a DomiNode function handler for OpenAI-compatible function calling.
+ * Create a Dominus Node function handler for OpenAI-compatible function calling.
  *
  * Authenticates using the provided API key, then returns a handler function
- * that dispatches function calls to the appropriate DomiNode REST API endpoint.
+ * that dispatches function calls to the appropriate Dominus Node REST API endpoint.
  *
  * @param config - API key and optional base URL / timeout.
  * @returns A handler function: (name, args) => Promise<string>

package/dist/handler.js

@@ -1,8 +1,8 @@
 /**
- * DomiNode OpenAI-compatible function calling handler (TypeScript).
+ * Dominus Node OpenAI-compatible function calling handler (TypeScript).
  *
  * Provides a factory function that creates a handler for dispatching
- * OpenAI function calls to the DomiNode REST API. Works with any
+ * OpenAI function calls to the Dominus Node REST API. Works with any
  * function-calling LLM system: OpenAI GPT, Anthropic Claude tool_use,
  * Google Gemini, or custom implementations.
  *
@@ -312,6 +312,10 @@ async function apiRequest(config, method, path, body) {
         "Content-Type": "application/json",
         Authorization: `Bearer ${config.token}`,
     };
+    if (config.agentSecret) {
+        headers["X-DominusNode-Agent"] = "mcp";
+        headers["X-DominusNode-Agent-Secret"] = config.agentSecret;
+    }
     const response = await fetch(url, {
         method,
         headers,
@@ -364,10 +368,10 @@ function periodToDateRange(period) {
     return { since: since.toISOString(), until };
 }
 /**
- * Create a DomiNode function handler for OpenAI-compatible function calling.
+ * Create a Dominus Node function handler for OpenAI-compatible function calling.
  *
  * Authenticates using the provided API key, then returns a handler function
- * that dispatches function calls to the appropriate DomiNode REST API endpoint.
+ * that dispatches function calls to the appropriate Dominus Node REST API endpoint.
  *
  * @param config - API key and optional base URL / timeout.
  * @returns A handler function: (name, args) => Promise<string>
@@ -392,6 +396,7 @@ export { isPrivateIp, validateUrl, normalizeIpv4, sanitizeError, stripDangerousK
 export function createDominusNodeFunctionHandler(config) {
     const baseUrl = config.baseUrl ?? "https://api.dominusnode.com";
     const timeoutMs = config.timeoutMs ?? 30_000;
+    const agentSecret = config.agentSecret || process.env.DOMINUSNODE_AGENT_SECRET;
     if (!config.apiKey || typeof config.apiKey !== "string") {
         throw new Error("apiKey is required and must be a non-empty string");
     }
@@ -399,12 +404,17 @@ export function createDominusNodeFunctionHandler(config) {
     let authToken = null;
     let authPromise = null;
     async function authenticate() {
+        const authHeaders = {
+            "User-Agent": "dominusnode-openai-functions/1.0.0",
+            "Content-Type": "application/json",
+        };
+        if (agentSecret) {
+            authHeaders["X-DominusNode-Agent"] = "mcp";
+            authHeaders["X-DominusNode-Agent-Secret"] = agentSecret;
+        }
         const response = await fetch(`${baseUrl}/api/auth/verify-key`, {
             method: "POST",
-            headers: {
-                "User-Agent": "dominusnode-openai-functions/1.0.0",
-                "Content-Type": "application/json",
-            },
+            headers: authHeaders,
             body: JSON.stringify({ apiKey: config.apiKey }),
             signal: AbortSignal.timeout(timeoutMs),
             redirect: "error",
@@ -432,7 +442,7 @@ export function createDominusNodeFunctionHandler(config) {
     function api(method, path, body) {
         if (!authToken)
             throw new Error("Not authenticated");
-        return apiRequest({ baseUrl, timeoutMs, token: authToken }, method, path, body);
+        return apiRequest({ baseUrl, timeoutMs, token: authToken, agentSecret }, method, path, body);
     }
     // -----------------------------------------------------------------------
     // Function handlers
@@ -487,7 +497,7 @@ export function createDominusNodeFunctionHandler(config) {
         }
         const username = userParts.join("-");
         // Use the proxy gateway for the actual request
-        // The handler routes through the DomiNode proxy endpoint
+        // The handler routes through the Dominus Node proxy endpoint
         try {
             // Strip security-sensitive headers from user-provided headers
             const BLOCKED_HEADERS = new Set([
@@ -640,7 +650,7 @@ export function createDominusNodeFunctionHandler(config) {
         catch (err) {
             return JSON.stringify({
                 error: `Proxy fetch failed: ${sanitizeError(err instanceof Error ? err.message : String(err))}`,
-                hint: "Ensure the DomiNode proxy gateway is running and accessible.",
+                hint: "Ensure the Dominus Node proxy gateway is running and accessible.",
             });
         }
     }
@@ -923,6 +933,40 @@ export function createDominusNodeFunctionHandler(config) {
         const result = await api("POST", "/api/wallet/topup/paypal", { amountCents });
         return JSON.stringify(result);
     }
+    async function handleTopupStripe(args) {
+        const amountCents = args.amount_cents;
+        if (!Number.isInteger(amountCents) ||
+            amountCents < 500 ||
+            amountCents > 100_000) {
+            return JSON.stringify({
+                error: "amount_cents must be an integer between 500 ($5) and 100,000 ($1,000)",
+            });
+        }
+        const result = await api("POST", "/api/wallet/topup/stripe", { amountCents });
+        return JSON.stringify(result);
+    }
+    async function handleTopupCrypto(args) {
+        const amountUsd = args.amount_usd;
+        const currency = args.currency;
+        if (typeof amountUsd !== "number" || !Number.isFinite(amountUsd) || amountUsd < 5 || amountUsd > 1000) {
+            return JSON.stringify({
+                error: "amount_usd must be a number between 5 and 1,000",
+            });
+        }
+        const validCurrencies = new Set([
+            "BTC", "ETH", "LTC", "XMR", "ZEC", "USDC", "SOL", "USDT", "DAI", "BNB", "LINK",
+        ]);
+        if (!currency || typeof currency !== "string" || !validCurrencies.has(currency.toUpperCase())) {
+            return JSON.stringify({
+                error: "currency must be one of: BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, LINK",
+            });
+        }
+        const result = await api("POST", "/api/wallet/topup/crypto", {
+            amountUsd,
+            currency: currency.toLowerCase(),
+        });
+        return JSON.stringify(result);
+    }
     async function handleUpdateWalletPolicy(args) {
         const walletId = args.wallet_id;
         if (!walletId || typeof walletId !== "string") {
@@ -1033,6 +1077,8 @@ export function createDominusNodeFunctionHandler(config) {
         dominusnode_update_team: handleUpdateTeam,
         dominusnode_update_team_member_role: handleUpdateTeamMemberRole,
         dominusnode_topup_paypal: handleTopupPaypal,
+        dominusnode_topup_stripe: handleTopupStripe,
+        dominusnode_topup_crypto: handleTopupCrypto,
         dominusnode_x402_info: handleX402Info,
     };
     async function handleX402Info() {

package/functions.json

@@ -1,7 +1,7 @@
 [
   {
     "name": "dominusnode_proxied_fetch",
-    "description": "Make an HTTP request through DomiNode's rotating proxy network. Routes traffic through datacenter ($3/GB) or residential ($5/GB) proxies with optional geo-targeting. Useful for accessing geo-restricted content, avoiding IP blocks, or web scraping. Private/internal IPs and sanctioned countries (CU, IR, KP, RU, SY) are blocked.",
+    "description": "Make an HTTP request through Dominus Node's rotating proxy network. Routes traffic through datacenter ($3/GB) or residential ($5/GB) proxies with optional geo-targeting. Useful for accessing geo-restricted content, avoiding IP blocks, or web scraping. Private/internal IPs and sanctioned countries (CU, IR, KP, RU, SY) are blocked.",
     "parameters": {
       "type": "object",
       "properties": {
@@ -38,7 +38,7 @@
   },
   {
     "name": "dominusnode_check_balance",
-    "description": "Check the current wallet balance for the authenticated DomiNode account. Returns balance in cents and USD, currency, and last top-up timestamp. The wallet uses a prepaid model -- top up first, then usage is debited automatically.",
+    "description": "Check the current wallet balance for the authenticated Dominus Node account. Returns balance in cents and USD, currency, and last top-up timestamp. The wallet uses a prepaid model -- top up first, then usage is debited automatically.",
     "parameters": {
       "type": "object",
       "properties": {},
@@ -47,7 +47,7 @@
   },
   {
     "name": "dominusnode_check_usage",
-    "description": "Check proxy usage statistics for the authenticated DomiNode account. Returns total bytes transferred, total cost, and request count for the specified period. Useful for monitoring bandwidth consumption and spending.",
+    "description": "Check proxy usage statistics for the authenticated Dominus Node account. Returns total bytes transferred, total cost, and request count for the specified period. Useful for monitoring bandwidth consumption and spending.",
     "parameters": {
       "type": "object",
       "properties": {
@@ -63,7 +63,7 @@
   },
   {
     "name": "dominusnode_get_proxy_config",
-    "description": "Get DomiNode proxy endpoint configuration and supported features. Returns HTTP and SOCKS5 proxy connection details, list of supported countries for geo-targeting, blocked/sanctioned countries, and geo-targeting capabilities. Use this to discover available proxy endpoints before making proxied requests.",
+    "description": "Get Dominus Node proxy endpoint configuration and supported features. Returns HTTP and SOCKS5 proxy connection details, list of supported countries for geo-targeting, blocked/sanctioned countries, and geo-targeting capabilities. Use this to discover available proxy endpoints before making proxied requests.",
     "parameters": {
       "type": "object",
       "properties": {},
@@ -72,7 +72,7 @@
   },
   {
     "name": "dominusnode_list_sessions",
-    "description": "List all currently active proxy sessions for the authenticated DomiNode account. Returns session IDs, start times, and status. Useful for monitoring concurrent connections and debugging active proxy usage.",
+    "description": "List all currently active proxy sessions for the authenticated Dominus Node account. Returns session IDs, start times, and status. Useful for monitoring concurrent connections and debugging active proxy usage.",
     "parameters": {
       "type": "object",
       "properties": {},
@@ -402,7 +402,7 @@
   },
   {
     "name": "dominusnode_topup_paypal",
-    "description": "Create a PayPal payment order to top up your DomiNode wallet. Returns an approval URL where you complete the payment. After approval, the wallet is credited automatically. Lower fees than Stripe for PayPal users. Minimum $5 (500 cents), maximum $1,000 (100,000 cents).",
+    "description": "Create a PayPal payment order to top up your Dominus Node wallet. Returns an approval URL where you complete the payment. After approval, the wallet is credited automatically. Lower fees than Stripe for PayPal users. Minimum $5 (500 cents), maximum $1,000 (100,000 cents).",
     "parameters": {
       "type": "object",
       "properties": {
@@ -415,5 +415,51 @@
       },
       "required": ["amount_cents"]
     }
+  },
+  {
+    "name": "dominusnode_topup_stripe",
+    "description": "Create a Stripe checkout session to top up your Dominus Node wallet with credit/debit card, Apple Pay, Google Pay, or Link. Returns a checkout URL. After payment, wallet is credited automatically. Minimum $5 (500 cents), maximum $1,000 (100,000 cents).",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "amount_cents": {
+          "type": "integer",
+          "description": "Amount in cents to add to wallet. Minimum 500 ($5.00), maximum 100000 ($1,000.00).",
+          "minimum": 500,
+          "maximum": 100000
+        }
+      },
+      "required": ["amount_cents"]
+    }
+  },
+  {
+    "name": "dominusnode_topup_crypto",
+    "description": "Create a cryptocurrency payment invoice to top up your Dominus Node wallet. Supports BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, and LINK. Returns a payment URL with address and amount. Privacy coins (XMR, ZEC) provide anonymous billing. Minimum $5, maximum $1,000.",
+    "parameters": {
+      "type": "object",
+      "properties": {
+        "amount_usd": {
+          "type": "number",
+          "description": "Amount in USD to add to wallet. Minimum 5, maximum 1000.",
+          "minimum": 5,
+          "maximum": 1000
+        },
+        "currency": {
+          "type": "string",
+          "description": "Cryptocurrency to pay with: BTC, ETH, LTC, XMR, ZEC, USDC, SOL, USDT, DAI, BNB, or LINK.",
+          "enum": ["BTC", "ETH", "LTC", "XMR", "ZEC", "USDC", "SOL", "USDT", "DAI", "BNB", "LINK"]
+        }
+      },
+      "required": ["amount_usd", "currency"]
+    }
+  },
+  {
+    "name": "dominusnode_x402_info",
+    "description": "Get x402 micropayment protocol information for pay-per-request proxy access. Returns the accepted payment networks (Coinbase Base USDC, PayAI Solana USDC, Polygon, Avalanche, Sei, and more), per-request pricing, and how to use the X-PAYMENT header for zero-signup proxy access. Use this when you want to pay per-request without a wallet top-up.",
+    "parameters": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    }
   }
 ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dominusnode/openai-functions",
-  "version": "1.0.0",
-  "description": "DomiNode OpenAI-compatible function calling handler — dispatches LLM function calls to the DomiNode REST API",
+  "version": "1.1.0",
+  "description": "Dominus Node OpenAI-compatible function calling handler — dispatches LLM function calls to the Dominus Node REST API",
   "main": "dist/handler.js",
   "types": "dist/handler.d.ts",
   "type": "module",