dominusnode-gemini 2.1.0__tar.gz

dominusnode_gemini-2.1.0/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+## 2.0.0 (2026-11-06)
+
+### Breaking
+
+- Rebuilt on the DominusNode SDK v2: exposes exactly the 19 standard relay-network tools
+  (fetch, proxy_url, network_policy/pricing/stats, balance, transactions, topup_crypto, check_payment, usage,
+  active_sessions, report_session, node_list, node_tier, node_setup_guide, credits_balance, credits_convert,
+  payouts_list, x402_info).
+- Removed Stripe/PayPal top-ups, plans, slots, teams/agentic-wallet/key management, email/password and MFA
+  flows, hardcoded prices and dc-/residential- pool prefixes.
+- Removed the bundled HTTP client and SSRF code; the SDK now provides HTTP, DNS-rebinding checks, OFAC refusal
+  and credential scrubbing.
+- TypeScript handler now uses @dominusnode/sdk v2; the Python handler is the dominusnode_gemini package on the dominusnode SDK v2. functions.json is generated and parity-tested in both languages.
+
+### Added
+
+- Live pricing via network_pricing, node earnings tools and a node agent setup guide.
+- The API key is read only from DOMINUSNODE_API_KEY/config; proxy_url returns a key placeholder.
+
+## 1.0.1
+
+- Fix branding: replace "DomiNode" with "Dominus Node" throughout
+
+All notable changes to this project will be documented in this file.
+
+## [2.1.0] - 2026-11-12
+
+### Added
+- The fetch tool's `ip_class` accepts `masked` (cheapest, VPN/anonymizer exits, opt-in; never used unless asked).
+
+### Changed
+- Requires the DominusNode SDK 2.1.0 or later (`masked` support).
+
+## [1.0.0] - 2025-02-23
+
+### Added
+- Initial release of Dominus Node Gemini / Vertex AI function declarations
+- 22 Gemini-format function declarations in `functions.json`
+  - All 21 functions from OpenAI Functions integration adapted to Gemini schema
+  - New `dominusnode_topup_paypal` function for PayPal wallet top-ups
+- TypeScript handler (`handler.ts`) with full security suite
+- Python handler (`handler.py`) with full security suite
+- Comprehensive SSRF prevention (private IPs, hex/octal/decimal, DNS rebinding, IPv6)
+- OFAC sanctioned country blocking (CU, IR, KP, RU, SY)
+- Credential sanitization in all error messages
+- Prototype pollution prevention in JSON parsing
+- HTTP method restriction (GET, HEAD, OPTIONS only for proxied fetch)
+- 401 retry logic for expired JWT tokens
+- TypeScript tests (`handler.test.ts`) -- 35+ test cases
+- Python tests (`test_handler.py`) -- 35+ test cases

dominusnode_gemini-2.1.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_gemini-2.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+# sdist contents: package source, metadata and docs only (see scripts/release/check-artifacts.mjs)
+include README.md
+include CHANGELOG.md
+include LICENSE
+prune tests
+exclude conftest.py
+prune examples
+global-exclude *.py[cod] __pycache__ *.map .env .env.* *.log

dominusnode_gemini-2.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: dominusnode-gemini
+Version: 2.1.0
+Summary: DominusNode v2 function declarations and handler for Google Gemini / Vertex AI, built on the dominusnode SDK
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/0xcircuitbreaker/DomiNode/tree/master/integrations/gemini
+Project-URL: Repository, https://github.com/0xcircuitbreaker/DomiNode
+Project-URL: Issues, https://github.com/0xcircuitbreaker/DomiNode/issues
+Project-URL: Changelog, https://github.com/0xcircuitbreaker/DomiNode/blob/master/integrations/gemini/CHANGELOG.md
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dominusnode<3,>=2.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Provides-Extra: genai
+Requires-Dist: google-genai>=1.0; extra == "genai"
+Dynamic: license-file
+
+# DominusNode for Google Gemini / Vertex AI
+
+Gives agents the DominusNode AI-agent relay network: fetch public web pages through exit IPs contributed by
+other agents' nodes, pay per GB from a prepaid crypto wallet, and earn by contributing your own IP with the
+node agent. Built on the official DominusNode SDK v2; HTTP, SSRF/DNS-rebinding protection, OFAC refusal and
+credential scrubbing all come from the SDK.
+
+## Install
+
+```bash
+npm install @dominusnode/gemini-functions   # TypeScript
+pip install dominusnode-gemini              # Python
+```
+
+## Configuration
+
+| Variable | Required | Purpose |
+|---|---|---|
+| `DOMINUSNODE_API_KEY` | yes | Your `dn_live_` API key. Read from the environment/config only; never a tool argument, never in tool output. |
+| `DOMINUSNODE_BASE_URL` | no | API base URL (default `https://api.dominusnode.com`). |
+| `DOMINUSNODE_PROXY_HOST` | no | Gateway host (default `proxy.dominusnode.com`). |
+
+## Usage
+
+This package has a TypeScript part (`@dominusnode/gemini-functions`, on `@dominusnode/sdk` v2) and a Python part
+(`dominusnode-gemini`, on the `dominusnode` SDK v2). Both expose the same 19 declarations, kept identical to
+`functions.json` by tests in each language. Declarations use Gemini's schema subset (uppercase types, `enum`
+with `format: "enum"`).
+
+### TypeScript (@google/genai)
+
+```ts
+import { GoogleGenAI } from "@google/genai";
+import { createDominusNodeFunctionHandler, functionDeclarations } from "@dominusnode/gemini-functions";
+
+const ai = new GoogleGenAI({});
+const handle = createDominusNodeFunctionHandler();          // key from DOMINUSNODE_API_KEY
+const res = await ai.models.generateContent({
+  model: "gemini-2.5-flash",
+  contents: "Fetch https://example.com from a German exit",
+  config: { tools: [{ functionDeclarations }] },
+});
+for (const call of res.functionCalls ?? []) {
+  const result = await handle(call.name!, call.args ?? {});
+  // reply with { functionResponse: { name: call.name, response: JSON.parse(result) } }
+}
+```
+
+### Python (google-genai)
+
+```python
+from google import genai
+from google.genai import types
+from dominusnode_gemini import create_dominusnode_function_handler, function_declarations
+
+handle = create_dominusnode_function_handler()      # key from DOMINUSNODE_API_KEY
+tool = types.Tool(function_declarations=function_declarations())
+resp = genai.Client().models.generate_content(
+    model="gemini-2.5-flash", contents="What does residential relay traffic cost per GB?",
+    config=types.GenerateContentConfig(tools=[tool]))
+for call in resp.function_calls or []:
+    result = handle(call.name, call.args or {})
+```
+
+Handlers return JSON strings; errors are `{"error": "..."}` with credentials scrubbed.
+
+## Tools (v2 standard set, 19)
+
+| # | Tool | What it does |
+|---|---|---|
+| 1 | `dominusnode_fetch` | Fetch a public URL through the DominusNode relay network (GET or HEAD only, ports 80/443, no redirects followed, 10 MB cap, private/internal targets refused). |
+| 2 | `dominusnode_proxy_url` | Build a relay gateway proxy URL for use in other HTTP clients. |
+| 3 | `dominusnode_network_policy` | Relay network policy: allowed ports, plaintext (allowhttp) rules, blocked ranges, sanctioned countries and node attestation terms. |
+| 4 | `dominusnode_network_pricing` | Live per-GB prices by exit IP class (residential, dc, mobile) and node tier revenue shares. |
+| 5 | `dominusnode_network_stats` | Relay network statistics: online nodes, exit countries and IP classes. |
+| 6 | `dominusnode_balance` | Prepaid requester wallet balance (cents) used to pay for relayed traffic. |
+| 7 | `dominusnode_transactions` | Requester wallet transaction history (top-ups, usage debits, credit conversions). |
+| 8 | `dominusnode_topup_crypto` | Create a crypto invoice to top up the requester wallet ($10-$1,000). |
+| 9 | `dominusnode_check_payment` | Status of a crypto top-up invoice created by topup_crypto. |
+| 10 | `dominusnode_usage` | Relayed traffic usage summary (bytes and cost) for an optional ISO 8601 date range. |
+| 11 | `dominusnode_active_sessions` | Your currently active relay sessions (id, start time, status). |
+| 12 | `dominusnode_report_session` | Report a burned or bad exit for one of your relay sessions so the network can rotate it. |
+| 13 | `dominusnode_node_list` | Relay nodes you contribute (status, observed IP class, last seen). |
+| 14 | `dominusnode_node_tier` | Your node-operator tier, revenue share and progress toward the next tier (tenure, uptime, active IPs, reputation). |
+| 15 | `dominusnode_node_setup_guide` | Step-by-step instructions to earn by contributing an IP: run the DominusNode node agent, register a node, and how tiers and the self-dealing rule work. |
+| 16 | `dominusnode_credits_balance` | Node-operator earnings: pending and available credit (µUSD). |
+| 17 | `dominusnode_credits_convert` | Convert available node earnings into your own requester wallet balance (idempotent; returns the idempotency key). |
+| 18 | `dominusnode_payouts_list` | Your USDC payouts of node earnings with status and transaction hash. |
+| 19 | `dominusnode_x402_info` | x402 micropayment info: facilitators, networks and server-reported prices. |
+
+Notes for agents:
+
+- Prices are never hardcoded: call `network_pricing` for the live per-GB price by IP class (residential, dc, mobile).
+- `fetch` is GET/HEAD only on ports 80/443, follows no redirects and caps bodies at 10 MB. Plaintext `http://`
+  needs `allow_http` and is visible to the exit node.
+- Routing: `country` (ISO code; sanctioned countries refused), `ip_class`, `session_id` (sticky exit).
+- Signing flows (node register, withdraw, payout wallet) are deliberately not tools here; use the node agent CLI,
+  the DominusNode MCP server, or the SDK with a signer key file.
+
+## Development (JS part)
+
+`@dominusnode/sdk` 2.x may not be on npm yet; link the in-repo SDK for local builds and tests:
+
+```bash
+(cd ../../sdks/node && npm ci && npm run build)
+npm install && npm run link-sdk
+npx tsc && npx vitest run
+```
+
+`functions.json` is generated from `core.ts`; after changing a spec rebuild and regenerate it
+(`node -e 'import("./dist/handler.js").then(m=>require("fs").writeFileSync("functions.json", JSON.stringify(m.functionDeclarations,null,2)+"\n"))'`).
+Tests in both languages fail if it is stale.
+
+## Testing
+
+```bash
+pip install -e ../../sdks/python -e '.[dev]'   # or npm install for the JS part
+python -m pytest -q python_tests
+```
+
+## License
+
+MIT

dominusnode_gemini-2.1.0/README.md

@@ -0,0 +1,123 @@
+# DominusNode for Google Gemini / Vertex AI
+
+Gives agents the DominusNode AI-agent relay network: fetch public web pages through exit IPs contributed by
+other agents' nodes, pay per GB from a prepaid crypto wallet, and earn by contributing your own IP with the
+node agent. Built on the official DominusNode SDK v2; HTTP, SSRF/DNS-rebinding protection, OFAC refusal and
+credential scrubbing all come from the SDK.
+
+## Install
+
+```bash
+npm install @dominusnode/gemini-functions   # TypeScript
+pip install dominusnode-gemini              # Python
+```
+
+## Configuration
+
+| Variable | Required | Purpose |
+|---|---|---|
+| `DOMINUSNODE_API_KEY` | yes | Your `dn_live_` API key. Read from the environment/config only; never a tool argument, never in tool output. |
+| `DOMINUSNODE_BASE_URL` | no | API base URL (default `https://api.dominusnode.com`). |
+| `DOMINUSNODE_PROXY_HOST` | no | Gateway host (default `proxy.dominusnode.com`). |
+
+## Usage
+
+This package has a TypeScript part (`@dominusnode/gemini-functions`, on `@dominusnode/sdk` v2) and a Python part
+(`dominusnode-gemini`, on the `dominusnode` SDK v2). Both expose the same 19 declarations, kept identical to
+`functions.json` by tests in each language. Declarations use Gemini's schema subset (uppercase types, `enum`
+with `format: "enum"`).
+
+### TypeScript (@google/genai)
+
+```ts
+import { GoogleGenAI } from "@google/genai";
+import { createDominusNodeFunctionHandler, functionDeclarations } from "@dominusnode/gemini-functions";
+
+const ai = new GoogleGenAI({});
+const handle = createDominusNodeFunctionHandler();          // key from DOMINUSNODE_API_KEY
+const res = await ai.models.generateContent({
+  model: "gemini-2.5-flash",
+  contents: "Fetch https://example.com from a German exit",
+  config: { tools: [{ functionDeclarations }] },
+});
+for (const call of res.functionCalls ?? []) {
+  const result = await handle(call.name!, call.args ?? {});
+  // reply with { functionResponse: { name: call.name, response: JSON.parse(result) } }
+}
+```
+
+### Python (google-genai)
+
+```python
+from google import genai
+from google.genai import types
+from dominusnode_gemini import create_dominusnode_function_handler, function_declarations
+
+handle = create_dominusnode_function_handler()      # key from DOMINUSNODE_API_KEY
+tool = types.Tool(function_declarations=function_declarations())
+resp = genai.Client().models.generate_content(
+    model="gemini-2.5-flash", contents="What does residential relay traffic cost per GB?",
+    config=types.GenerateContentConfig(tools=[tool]))
+for call in resp.function_calls or []:
+    result = handle(call.name, call.args or {})
+```
+
+Handlers return JSON strings; errors are `{"error": "..."}` with credentials scrubbed.
+
+## Tools (v2 standard set, 19)
+
+| # | Tool | What it does |
+|---|---|---|
+| 1 | `dominusnode_fetch` | Fetch a public URL through the DominusNode relay network (GET or HEAD only, ports 80/443, no redirects followed, 10 MB cap, private/internal targets refused). |
+| 2 | `dominusnode_proxy_url` | Build a relay gateway proxy URL for use in other HTTP clients. |
+| 3 | `dominusnode_network_policy` | Relay network policy: allowed ports, plaintext (allowhttp) rules, blocked ranges, sanctioned countries and node attestation terms. |
+| 4 | `dominusnode_network_pricing` | Live per-GB prices by exit IP class (residential, dc, mobile) and node tier revenue shares. |
+| 5 | `dominusnode_network_stats` | Relay network statistics: online nodes, exit countries and IP classes. |
+| 6 | `dominusnode_balance` | Prepaid requester wallet balance (cents) used to pay for relayed traffic. |
+| 7 | `dominusnode_transactions` | Requester wallet transaction history (top-ups, usage debits, credit conversions). |
+| 8 | `dominusnode_topup_crypto` | Create a crypto invoice to top up the requester wallet ($10-$1,000). |
+| 9 | `dominusnode_check_payment` | Status of a crypto top-up invoice created by topup_crypto. |
+| 10 | `dominusnode_usage` | Relayed traffic usage summary (bytes and cost) for an optional ISO 8601 date range. |
+| 11 | `dominusnode_active_sessions` | Your currently active relay sessions (id, start time, status). |
+| 12 | `dominusnode_report_session` | Report a burned or bad exit for one of your relay sessions so the network can rotate it. |
+| 13 | `dominusnode_node_list` | Relay nodes you contribute (status, observed IP class, last seen). |
+| 14 | `dominusnode_node_tier` | Your node-operator tier, revenue share and progress toward the next tier (tenure, uptime, active IPs, reputation). |
+| 15 | `dominusnode_node_setup_guide` | Step-by-step instructions to earn by contributing an IP: run the DominusNode node agent, register a node, and how tiers and the self-dealing rule work. |
+| 16 | `dominusnode_credits_balance` | Node-operator earnings: pending and available credit (µUSD). |
+| 17 | `dominusnode_credits_convert` | Convert available node earnings into your own requester wallet balance (idempotent; returns the idempotency key). |
+| 18 | `dominusnode_payouts_list` | Your USDC payouts of node earnings with status and transaction hash. |
+| 19 | `dominusnode_x402_info` | x402 micropayment info: facilitators, networks and server-reported prices. |
+
+Notes for agents:
+
+- Prices are never hardcoded: call `network_pricing` for the live per-GB price by IP class (residential, dc, mobile).
+- `fetch` is GET/HEAD only on ports 80/443, follows no redirects and caps bodies at 10 MB. Plaintext `http://`
+  needs `allow_http` and is visible to the exit node.
+- Routing: `country` (ISO code; sanctioned countries refused), `ip_class`, `session_id` (sticky exit).
+- Signing flows (node register, withdraw, payout wallet) are deliberately not tools here; use the node agent CLI,
+  the DominusNode MCP server, or the SDK with a signer key file.
+
+## Development (JS part)
+
+`@dominusnode/sdk` 2.x may not be on npm yet; link the in-repo SDK for local builds and tests:
+
+```bash
+(cd ../../sdks/node && npm ci && npm run build)
+npm install && npm run link-sdk
+npx tsc && npx vitest run
+```
+
+`functions.json` is generated from `core.ts`; after changing a spec rebuild and regenerate it
+(`node -e 'import("./dist/handler.js").then(m=>require("fs").writeFileSync("functions.json", JSON.stringify(m.functionDeclarations,null,2)+"\n"))'`).
+Tests in both languages fail if it is stale.
+
+## Testing
+
+```bash
+pip install -e ../../sdks/python -e '.[dev]'   # or npm install for the JS part
+python -m pytest -q python_tests
+```
+
+## License
+
+MIT

dominusnode_gemini-2.1.0/dominusnode_gemini/__init__.py

@@ -0,0 +1,58 @@
+"""DominusNode v2 function declarations and handler for Google Gemini / Vertex AI (Python).
+
+With the ``google-genai`` SDK::
+
+    from google import genai
+    from google.genai import types
+    from dominusnode_gemini import create_dominusnode_function_handler, function_declarations
+
+    handle = create_dominusnode_function_handler()      # key from DOMINUSNODE_API_KEY
+    tool = types.Tool(function_declarations=function_declarations())
+    resp = genai.Client().models.generate_content(
+        model="gemini-2.5-flash", contents="What does a GB of residential relay cost?",
+        config=types.GenerateContentConfig(tools=[tool]))
+    for call in resp.function_calls or []:
+        result = handle(call.name, call.args or {})    # JSON string -> send back as a function response
+"""
+
+from __future__ import annotations
+
+from typing import Any, Callable, Dict, List, Optional
+
+from dominusnode_gemini._core import PREFIX, TOOL_NAMES, TOOL_SPECS, DominusNodeTools
+
+
+def to_declaration(spec: Dict[str, Any]) -> Dict[str, Any]:
+    """Core spec -> Gemini FunctionDeclaration dict (uppercase types; no additionalProperties/min/max)."""
+    props: Dict[str, Any] = {}
+    for name, p in spec["parameters"]["properties"].items():
+        s: Dict[str, Any] = {"type": p["type"].upper(), "description": p["description"]}
+        if "enum" in p:
+            s["format"] = "enum"
+            s["enum"] = list(p["enum"])
+        props[name] = s
+    return {"name": PREFIX + spec["name"], "description": spec["description"],
+            "parameters": {"type": "OBJECT", "properties": props, "required": list(spec["parameters"]["required"])}}
+
+
+def function_declarations() -> List[Dict[str, Any]]:
+    """The 19 tools as Gemini FunctionDeclaration dicts (accepted by ``types.Tool(function_declarations=...)``)."""
+    return [to_declaration(s) for s in TOOL_SPECS]
+
+
+def create_dominusnode_function_handler(
+    api_key: Optional[str] = None, base_url: Optional[str] = None, proxy_host: Optional[str] = None,
+    client: Optional[Any] = None,
+) -> Callable[..., str]:
+    """``handler(name, args) -> JSON string``. ``api_key`` defaults to DOMINUSNODE_API_KEY (host config only)."""
+    tools = DominusNodeTools(api_key=api_key, base_url=base_url, proxy_host=proxy_host, client=client)
+
+    def handler(name: str, args: Optional[Dict[str, Any]] = None) -> str:
+        return tools.call(name, dict(args or {}))
+
+    return handler
+
+
+__version__ = "2.1.0"
+__all__ = ["create_dominusnode_function_handler", "function_declarations", "to_declaration", "DominusNodeTools",
+           "TOOL_NAMES", "__version__"]

dominusnode_gemini-2.1.0/dominusnode_gemini/_core.py

@@ -0,0 +1,279 @@
+"""DominusNode v2 standard tool set (19 tools), built on the ``dominusnode`` Python SDK.
+
+Framework-neutral: each tool has a name, an LLM-facing description and a JSON
+Schema for its arguments. ``DominusNodeTools.call(name, args)`` dispatches to
+the SDK and always returns a JSON string with credentials scrubbed. HTTP,
+SSRF/DNS-rebinding checks, OFAC refusal and signing all live in the SDK.
+
+The API key is read only from ``DOMINUSNODE_API_KEY`` (or passed by the host
+application as configuration); it is never a tool argument or tool output.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import threading
+from typing import Any, Callable, Dict, List, Optional
+
+from dominusnode import DominusNodeClient, DominusNodeError, scrub_credentials, json_default
+
+PREFIX = "dominusnode_"
+MAX_BODY_CHARS = 20_000
+_KEY_PLACEHOLDER = "${DOMINUSNODE_API_KEY}"
+
+_COUNTRY = {"type": "string", "description": "ISO 3166-1 alpha-2 exit country, e.g. US. Sanctioned countries are refused."}
+_IP_CLASS = {"type": "string", "enum": ["residential", "dc", "mobile", "masked"],
+             "description": "Exit IP class. Each class has its own per-GB price (see network_pricing); masked = cheapest, VPN/anonymizer exits, opt-in."}
+_SESSION = {"type": "string", "description": "Sticky session id (1-64 alphanumeric) to keep the same exit IP."}
+_ALLOW_HTTP = {"type": "boolean",
+               "description": "Opt in to plaintext http:// targets. Plaintext is visible to the exit node; prefer https."}
+_LIMIT = {"type": "integer", "minimum": 1, "description": "Maximum number of items."}
+_OFFSET = {"type": "integer", "minimum": 0, "description": "Items to skip."}
+
+
+def _obj(props: Optional[Dict[str, Any]] = None, required: Optional[List[str]] = None) -> Dict[str, Any]:
+    return {"type": "object", "properties": props or {}, "required": required or [], "additionalProperties": False}
+
+
+TOOL_SPECS: List[Dict[str, Any]] = [
+    {"name": "fetch", "description": (
+        "Fetch a public URL through the DominusNode relay network (GET or HEAD only, ports 80/443, no redirects "
+        "followed, 10 MB cap, private/internal targets refused). Billed per GB at the live price for the exit IP "
+        "class (see network_pricing). http:// targets need allow_http=true and are visible to the exit node."),
+     "parameters": _obj({"url": {"type": "string", "description": "https:// URL (or http:// with allow_http)."},
+                         "method": {"type": "string", "enum": ["GET", "HEAD"], "description": "HTTP method."},
+                         "country": _COUNTRY, "ip_class": _IP_CLASS, "session_id": _SESSION,
+                         "allow_http": _ALLOW_HTTP}, ["url"])},
+    {"name": "proxy_url", "description": (
+        "Build a relay gateway proxy URL for use in other HTTP clients. Routing flags go in the username "
+        "(country-XX, class-..., session-..., allowhttp-1). The password is shown as a ${DOMINUSNODE_API_KEY} "
+        "placeholder: substitute the key from the environment, never paste it into chat."),
+     "parameters": _obj({"country": _COUNTRY, "ip_class": _IP_CLASS, "session_id": _SESSION, "allow_http": _ALLOW_HTTP,
+                         "protocol": {"type": "string", "enum": ["http", "socks5"], "description": "Proxy protocol."}})},
+    {"name": "network_policy", "description": (
+        "Relay network policy: allowed ports, plaintext (allowhttp) rules, blocked ranges, sanctioned countries "
+        "and node attestation terms."), "parameters": _obj()},
+    {"name": "network_pricing", "description": (
+        "Live per-GB prices by exit IP class (residential, dc, mobile, masked) and node tier revenue shares. Always use "
+        "this for prices; never assume them."), "parameters": _obj()},
+    {"name": "network_stats", "description": "Relay network statistics: online nodes, exit countries and IP classes.",
+     "parameters": _obj()},
+    {"name": "balance", "description": "Prepaid requester wallet balance (cents) used to pay for relayed traffic.",
+     "parameters": _obj()},
+    {"name": "transactions", "description": "Requester wallet transaction history (top-ups, usage debits, credit conversions).",
+     "parameters": _obj({"limit": _LIMIT, "offset": _OFFSET})},
+    {"name": "topup_crypto", "description": (
+        "Create a crypto invoice to top up the requester wallet ($10-$1,000). Returns a payment address/URL; "
+        "the wallet is credited after on-chain confirmation (check with check_payment)."),
+     "parameters": _obj({"amount_cents": {"type": "integer", "minimum": 1000, "maximum": 100000,
+                                          "description": "Amount in US cents (1000 = $10)."},
+                         "currency": {"type": "string", "enum": ["btc", "eth", "ltc", "xmr", "zec", "usdc", "sol",
+                                                                 "usdt", "dai", "bnb", "link"],
+                                      "description": "Cryptocurrency to pay with."}}, ["amount_cents", "currency"])},
+    {"name": "check_payment", "description": "Status of a crypto top-up invoice created by topup_crypto.",
+     "parameters": _obj({"invoice_id": {"type": "string", "description": "Invoice UUID."}}, ["invoice_id"])},
+    {"name": "usage", "description": "Relayed traffic usage summary (bytes and cost) for an optional ISO 8601 date range.",
+     "parameters": _obj({"from": {"type": "string", "description": "ISO 8601 start."},
+                         "to": {"type": "string", "description": "ISO 8601 end."}})},
+    {"name": "active_sessions", "description": "Your currently active relay sessions (id, start time, status).",
+     "parameters": _obj()},
+    {"name": "report_session", "description": (
+        "Report a burned or bad exit for one of your relay sessions so the network can rotate it."),
+     "parameters": _obj({"session_id": {"type": "string", "description": "Session UUID from active_sessions."},
+                         "reason": {"type": "string", "enum": ["blocked", "captcha", "rate_limited", "slow",
+                                                               "bad_content", "other"],
+                                    "description": "Why the exit is bad."}}, ["session_id", "reason"])},
+    {"name": "node_list", "description": (
+        "Relay nodes you contribute (status, observed IP class, last seen). Contributing IPs earns credit."),
+     "parameters": _obj({"limit": _LIMIT, "offset": _OFFSET})},
+    {"name": "node_tier", "description": (
+        "Your node-operator tier, revenue share and progress toward the next tier (tenure, uptime, active IPs, reputation)."),
+     "parameters": _obj()},
+    {"name": "node_setup_guide", "description": (
+        "Step-by-step instructions to earn by contributing an IP: run the DominusNode node agent, register a node, "
+        "and how tiers and the self-dealing rule work."), "parameters": _obj()},
+    {"name": "credits_balance", "description": "Node-operator earnings: pending and available credit (µUSD).",
+     "parameters": _obj()},
+    {"name": "credits_convert", "description": (
+        "Convert available node earnings into your own requester wallet balance (idempotent; returns the idempotency key)."),
+     "parameters": _obj({"amount_musd": {"type": "string",
+                                         "description": "Amount in micro-USD as a digit string (min 10000 = $0.01)."}},
+                        ["amount_musd"])},
+    {"name": "payouts_list", "description": "Your USDC payouts of node earnings with status and transaction hash.",
+     "parameters": _obj({"limit": _LIMIT, "offset": _OFFSET})},
+    {"name": "x402_info", "description": "x402 micropayment info: facilitators, networks and server-reported prices.",
+     "parameters": _obj()},
+]
+
+TOOL_NAMES: List[str] = [t["name"] for t in TOOL_SPECS]
+SPECS_BY_NAME: Dict[str, Dict[str, Any]] = {t["name"]: t for t in TOOL_SPECS}
+
+NODE_SETUP_GUIDE = "\n".join([
+    "DominusNode relay node setup (earn by contributing an IP)",
+    "",
+    "How earning works",
+    "  - Your node dials OUT to the gateway (no inbound ports) and relays other agents' traffic.",
+    "  - You earn your tier's share of each paid GB relayed; live prices and shares: network_pricing.",
+    "  - Self-dealing earns nothing: your own, your wallet's, team's or /24's traffic never routes to your node.",
+    "  - Tiers rise with paid tenure, uptime, active IPs and reputation (node_tier).",
+    "  - Nodes only dial ports 80/443, never private/metadata targets or SMTP/SSH/RDP (network_policy).",
+    "",
+    "Steps",
+    "  1. Store your owner wallet key in a private file (never pass it to a tool or chat):",
+    "     umask 077 && printf '%s' \"$WALLET_PRIVATE_KEY_HEX\" > ~/.dominusnode/wallet.key",
+    "  2. On the machine whose IP you contribute (Node.js >= 18):",
+    "     git clone https://github.com/0xcircuitbreaker/DomiNode.git && cd DomiNode",
+    "     npm ci && npm run build -w @dominusnode/shared -w @dominusnode/node-agent",
+    "     export DN_API_KEY   # your dn_live_ key, from the environment only",
+    "     node packages/node-agent/dist/src/main.js register --wallet-key-file ~/.dominusnode/wallet.key",
+    "  3. Run it and keep it running (systemd/pm2) - uptime drives your tier:",
+    "     node packages/node-agent/dist/src/main.js run --key-file ~/.dominusnode/node.json",
+    "  4. Verify with node_list and node_tier; earnings appear in credits_balance.",
+    "",
+    "Signing flows (node register, withdraw, payout wallet) are not available as tools here; use the",
+    "node agent CLI, the DominusNode MCP server or the SDK with a signer key file.",
+])
+
+
+def _scrub(text: str, key: Optional[str]) -> str:
+    out = scrub_credentials(text)
+    if key:
+        out = out.replace(key, "[REDACTED]")
+    return out
+
+
+def _opt_int(args: Dict[str, Any], name: str) -> Optional[int]:
+    v = args.get(name)
+    if v is None:
+        return None
+    if isinstance(v, bool):
+        raise ValueError(f"{name} must be an integer")
+    return int(v)
+
+
+class DominusNodeTools:
+    """Dispatches the 19 standard tools to a connected ``DominusNodeClient``."""
+
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None,
+                 proxy_host: Optional[str] = None, client: Optional[Any] = None) -> None:
+        self._api_key = api_key or os.environ.get("DOMINUSNODE_API_KEY") or None
+        self._base_url = base_url or os.environ.get("DOMINUSNODE_BASE_URL") or None
+        self._proxy_host = proxy_host or os.environ.get("DOMINUSNODE_PROXY_HOST") or None
+        self._client = client
+        self._connected = client is not None
+        self._lock = threading.Lock()
+
+    def __repr__(self) -> str:
+        return "DominusNodeTools(api_key=[REDACTED])"
+
+    __str__ = __repr__
+
+    def _sdk(self) -> Any:
+        with self._lock:
+            if self._client is None:
+                kw: Dict[str, Any] = {}
+                if self._base_url:
+                    kw["base_url"] = self._base_url
+                if self._proxy_host:
+                    kw["proxy_host"] = self._proxy_host
+                self._client = DominusNodeClient(**kw)
+            if not self._connected:
+                if not self._api_key:
+                    raise DominusNodeError("DOMINUSNODE_API_KEY is not set")
+                self._client.connect_with_key(self._api_key)
+                self._connected = True
+            return self._client
+
+    # ---- tool implementations -------------------------------------------------
+    def _fetch(self, a: Dict[str, Any]) -> Any:
+        r = self._sdk().proxy.fetch(
+            str(a["url"]), method=str(a.get("method") or "GET").upper(), country=a.get("country"),
+            ip_class=a.get("ip_class"), session_id=a.get("session_id"), allow_http=bool(a.get("allow_http", False)))
+        body = r.text()
+        cut = len(body) > MAX_BODY_CHARS
+        return {"status": r.status, "statusText": r.status_text,
+                "contentType": (r.headers or {}).get("content-type"),
+                "location": (r.headers or {}).get("location"),
+                "truncated": bool(r.truncated or cut), "body": body[:MAX_BODY_CHARS]}
+
+    def _proxy_url(self, a: Dict[str, Any]) -> Any:
+        c = self._sdk()
+        url = c.proxy.build_url(country=a.get("country"), ip_class=a.get("ip_class"), session_id=a.get("session_id"),
+                                allow_http=bool(a.get("allow_http", False)), protocol=str(a.get("protocol") or "http"))
+        user = url.split("://", 1)[1].split(":", 1)[0]
+        prefix, rest = url.split("@", 1)[0], url.split("@", 1)[1]
+        scheme = prefix.split("://", 1)[0]
+        return {"proxyUrl": f"{scheme}://{user}:{_KEY_PLACEHOLDER}@{rest}", "username": user,
+                "note": "Replace the placeholder with DOMINUSNODE_API_KEY from your environment."}
+
+    def _dispatch(self, name: str, a: Dict[str, Any]) -> Any:
+        if name == "fetch":
+            return self._fetch(a)
+        if name == "proxy_url":
+            return self._proxy_url(a)
+        if name == "node_setup_guide":
+            return {"guide": NODE_SETUP_GUIDE}
+        c = self._sdk()
+        if name == "network_policy":
+            return c.network.policy()
+        if name == "network_pricing":
+            return c.network.pricing()
+        if name == "network_stats":
+            return c.network.stats()
+        if name == "balance":
+            return c.wallet.get_balance()
+        if name == "transactions":
+            return c.wallet.get_transactions(limit=_opt_int(a, "limit"), offset=_opt_int(a, "offset"))
+        if name == "topup_crypto":
+            return c.wallet.top_up_crypto(int(a["amount_cents"]), str(a["currency"]))
+        if name == "check_payment":
+            return c.wallet.get_crypto_status(str(a["invoice_id"]))
+        if name == "usage":
+            return c.usage.get(from_=a.get("from"), to=a.get("to"))
+        if name == "active_sessions":
+            return c.sessions.get_active()
+        if name == "report_session":
+            return c.sessions.report(str(a["session_id"]), str(a["reason"]))
+        if name == "node_list":
+            return c.nodes.list(limit=_opt_int(a, "limit"), offset=_opt_int(a, "offset"))
+        if name == "node_tier":
+            return c.nodes.tier()
+        if name == "credits_balance":
+            return c.credits.balance()
+        if name == "credits_convert":
+            return c.credits.convert(str(a["amount_musd"]))
+        if name == "payouts_list":
+            return c.payouts.list(limit=_opt_int(a, "limit"), offset=_opt_int(a, "offset"))
+        if name == "x402_info":
+            return c.x402.get_info()
+        raise ValueError(f"unknown tool: {name}")
+
+    def call(self, name: str, args: Optional[Dict[str, Any]] = None) -> str:
+        """Run a tool by its standard name (prefix optional). Always returns a scrubbed JSON string."""
+        if name.startswith(PREFIX):
+            name = name[len(PREFIX):]
+        args = {k: v for k, v in (args or {}).items() if v is not None}
+        try:
+            if name not in SPECS_BY_NAME:
+                raise ValueError(f"unknown tool: {name}")
+            allowed = SPECS_BY_NAME[name]["parameters"]["properties"]
+            unknown = [k for k in args if k not in allowed]
+            if unknown:
+                raise ValueError(f"unexpected argument(s): {', '.join(sorted(unknown))}")
+            out = json.dumps(self._dispatch(name, args), default=json_default)
+        except Exception as err:  # noqa: BLE001 - every error is returned to the model, scrubbed
+            msg = f"{type(err).__name__}: {err}" if not isinstance(err, DominusNodeError) else str(err)
+            out = json.dumps({"error": msg})
+        return _scrub(out, self._api_key)
+
+
+def make_tool_callables(tools: DominusNodeTools) -> Dict[str, Callable[..., str]]:
+    """``{prefixed_name: fn(**kwargs) -> str}`` for frameworks that take plain functions."""
+    def mk(n: str) -> Callable[..., str]:
+        def fn(**kwargs: Any) -> str:
+            return tools.call(n, kwargs)
+        fn.__name__ = PREFIX + n
+        fn.__doc__ = SPECS_BY_NAME[n]["description"]
+        return fn
+    return {PREFIX + n: mk(n) for n in TOOL_NAMES}

dominusnode_gemini-2.1.0/dominusnode_gemini.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: dominusnode-gemini
+Version: 2.1.0
+Summary: DominusNode v2 function declarations and handler for Google Gemini / Vertex AI, built on the dominusnode SDK
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/0xcircuitbreaker/DomiNode/tree/master/integrations/gemini
+Project-URL: Repository, https://github.com/0xcircuitbreaker/DomiNode
+Project-URL: Issues, https://github.com/0xcircuitbreaker/DomiNode/issues
+Project-URL: Changelog, https://github.com/0xcircuitbreaker/DomiNode/blob/master/integrations/gemini/CHANGELOG.md
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dominusnode<3,>=2.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Provides-Extra: genai
+Requires-Dist: google-genai>=1.0; extra == "genai"
+Dynamic: license-file
+
+# DominusNode for Google Gemini / Vertex AI
+
+Gives agents the DominusNode AI-agent relay network: fetch public web pages through exit IPs contributed by
+other agents' nodes, pay per GB from a prepaid crypto wallet, and earn by contributing your own IP with the
+node agent. Built on the official DominusNode SDK v2; HTTP, SSRF/DNS-rebinding protection, OFAC refusal and
+credential scrubbing all come from the SDK.
+
+## Install
+
+```bash
+npm install @dominusnode/gemini-functions   # TypeScript
+pip install dominusnode-gemini              # Python
+```
+
+## Configuration
+
+| Variable | Required | Purpose |
+|---|---|---|
+| `DOMINUSNODE_API_KEY` | yes | Your `dn_live_` API key. Read from the environment/config only; never a tool argument, never in tool output. |
+| `DOMINUSNODE_BASE_URL` | no | API base URL (default `https://api.dominusnode.com`). |
+| `DOMINUSNODE_PROXY_HOST` | no | Gateway host (default `proxy.dominusnode.com`). |
+
+## Usage
+
+This package has a TypeScript part (`@dominusnode/gemini-functions`, on `@dominusnode/sdk` v2) and a Python part
+(`dominusnode-gemini`, on the `dominusnode` SDK v2). Both expose the same 19 declarations, kept identical to
+`functions.json` by tests in each language. Declarations use Gemini's schema subset (uppercase types, `enum`
+with `format: "enum"`).
+
+### TypeScript (@google/genai)
+
+```ts
+import { GoogleGenAI } from "@google/genai";
+import { createDominusNodeFunctionHandler, functionDeclarations } from "@dominusnode/gemini-functions";
+
+const ai = new GoogleGenAI({});
+const handle = createDominusNodeFunctionHandler();          // key from DOMINUSNODE_API_KEY
+const res = await ai.models.generateContent({
+  model: "gemini-2.5-flash",
+  contents: "Fetch https://example.com from a German exit",
+  config: { tools: [{ functionDeclarations }] },
+});
+for (const call of res.functionCalls ?? []) {
+  const result = await handle(call.name!, call.args ?? {});
+  // reply with { functionResponse: { name: call.name, response: JSON.parse(result) } }
+}
+```
+
+### Python (google-genai)
+
+```python
+from google import genai
+from google.genai import types
+from dominusnode_gemini import create_dominusnode_function_handler, function_declarations
+
+handle = create_dominusnode_function_handler()      # key from DOMINUSNODE_API_KEY
+tool = types.Tool(function_declarations=function_declarations())
+resp = genai.Client().models.generate_content(
+    model="gemini-2.5-flash", contents="What does residential relay traffic cost per GB?",
+    config=types.GenerateContentConfig(tools=[tool]))
+for call in resp.function_calls or []:
+    result = handle(call.name, call.args or {})
+```
+
+Handlers return JSON strings; errors are `{"error": "..."}` with credentials scrubbed.
+
+## Tools (v2 standard set, 19)
+
+| # | Tool | What it does |
+|---|---|---|
+| 1 | `dominusnode_fetch` | Fetch a public URL through the DominusNode relay network (GET or HEAD only, ports 80/443, no redirects followed, 10 MB cap, private/internal targets refused). |
+| 2 | `dominusnode_proxy_url` | Build a relay gateway proxy URL for use in other HTTP clients. |
+| 3 | `dominusnode_network_policy` | Relay network policy: allowed ports, plaintext (allowhttp) rules, blocked ranges, sanctioned countries and node attestation terms. |
+| 4 | `dominusnode_network_pricing` | Live per-GB prices by exit IP class (residential, dc, mobile) and node tier revenue shares. |
+| 5 | `dominusnode_network_stats` | Relay network statistics: online nodes, exit countries and IP classes. |
+| 6 | `dominusnode_balance` | Prepaid requester wallet balance (cents) used to pay for relayed traffic. |
+| 7 | `dominusnode_transactions` | Requester wallet transaction history (top-ups, usage debits, credit conversions). |
+| 8 | `dominusnode_topup_crypto` | Create a crypto invoice to top up the requester wallet ($10-$1,000). |
+| 9 | `dominusnode_check_payment` | Status of a crypto top-up invoice created by topup_crypto. |
+| 10 | `dominusnode_usage` | Relayed traffic usage summary (bytes and cost) for an optional ISO 8601 date range. |
+| 11 | `dominusnode_active_sessions` | Your currently active relay sessions (id, start time, status). |
+| 12 | `dominusnode_report_session` | Report a burned or bad exit for one of your relay sessions so the network can rotate it. |
+| 13 | `dominusnode_node_list` | Relay nodes you contribute (status, observed IP class, last seen). |
+| 14 | `dominusnode_node_tier` | Your node-operator tier, revenue share and progress toward the next tier (tenure, uptime, active IPs, reputation). |
+| 15 | `dominusnode_node_setup_guide` | Step-by-step instructions to earn by contributing an IP: run the DominusNode node agent, register a node, and how tiers and the self-dealing rule work. |
+| 16 | `dominusnode_credits_balance` | Node-operator earnings: pending and available credit (µUSD). |
+| 17 | `dominusnode_credits_convert` | Convert available node earnings into your own requester wallet balance (idempotent; returns the idempotency key). |
+| 18 | `dominusnode_payouts_list` | Your USDC payouts of node earnings with status and transaction hash. |
+| 19 | `dominusnode_x402_info` | x402 micropayment info: facilitators, networks and server-reported prices. |
+
+Notes for agents:
+
+- Prices are never hardcoded: call `network_pricing` for the live per-GB price by IP class (residential, dc, mobile).
+- `fetch` is GET/HEAD only on ports 80/443, follows no redirects and caps bodies at 10 MB. Plaintext `http://`
+  needs `allow_http` and is visible to the exit node.
+- Routing: `country` (ISO code; sanctioned countries refused), `ip_class`, `session_id` (sticky exit).
+- Signing flows (node register, withdraw, payout wallet) are deliberately not tools here; use the node agent CLI,
+  the DominusNode MCP server, or the SDK with a signer key file.
+
+## Development (JS part)
+
+`@dominusnode/sdk` 2.x may not be on npm yet; link the in-repo SDK for local builds and tests:
+
+```bash
+(cd ../../sdks/node && npm ci && npm run build)
+npm install && npm run link-sdk
+npx tsc && npx vitest run
+```
+
+`functions.json` is generated from `core.ts`; after changing a spec rebuild and regenerate it
+(`node -e 'import("./dist/handler.js").then(m=>require("fs").writeFileSync("functions.json", JSON.stringify(m.functionDeclarations,null,2)+"\n"))'`).
+Tests in both languages fail if it is stale.
+
+## Testing
+
+```bash
+pip install -e ../../sdks/python -e '.[dev]'   # or npm install for the JS part
+python -m pytest -q python_tests
+```
+
+## License
+
+MIT

dominusnode_gemini-2.1.0/dominusnode_gemini.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+dominusnode_gemini/__init__.py
+dominusnode_gemini/_core.py
+dominusnode_gemini.egg-info/PKG-INFO
+dominusnode_gemini.egg-info/SOURCES.txt
+dominusnode_gemini.egg-info/dependency_links.txt
+dominusnode_gemini.egg-info/requires.txt
+dominusnode_gemini.egg-info/top_level.txt

dominusnode_gemini-2.1.0/dominusnode_gemini.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dominusnode_gemini-2.1.0/dominusnode_gemini.egg-info/requires.txt

@@ -0,0 +1,7 @@
+dominusnode<3,>=2.1.0
+
+[dev]
+pytest>=7.0
+
+[genai]
+google-genai>=1.0

dominusnode_gemini-2.1.0/dominusnode_gemini.egg-info/top_level.txt

@@ -0,0 +1 @@
+dominusnode_gemini

dominusnode_gemini-2.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dominusnode-gemini"
+version = "2.1.0"
+description = "DominusNode v2 function declarations and handler for Google Gemini / Vertex AI, built on the dominusnode SDK"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+dependencies = ["dominusnode>=2.1.0,<3"]
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0"]
+genai = ["google-genai>=1.0"]
+
+[tool.setuptools.packages.find]
+include = ["dominusnode_gemini*"]
+
+[tool.pytest.ini_options]
+testpaths = ["python_tests"]
+
+[project.urls]
+Homepage = "https://github.com/0xcircuitbreaker/DomiNode/tree/master/integrations/gemini"
+Repository = "https://github.com/0xcircuitbreaker/DomiNode"
+Issues = "https://github.com/0xcircuitbreaker/DomiNode/issues"
+Changelog = "https://github.com/0xcircuitbreaker/DomiNode/blob/master/integrations/gemini/CHANGELOG.md"

dominusnode_gemini-2.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+