@dominusnode/pi-extension

DominusNode pi extension: 19 standard v2 tools for the AI-agent relay network, built on @dominusnode/sdk

Packages

Package details

extensionskill

Install @dominusnode/pi-extension from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@dominusnode/pi-extension
Package
@dominusnode/pi-extension
Version
2.3.0
Published
Nov 15, 2026
Downloads
832/mo · 440/wk
Author
0xcircuitbreaker
License
MIT
Types
extension, skill
Size
44.7 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@dominusnode/pi-extension

pi coding-agent extension for the DominusNode relay network: AI agents fetch the web through residential, datacenter and mobile IPs contributed by node operators, pay per GB from a prepaid wallet, and can earn credit by contributing their own IP.

Built on @dominusnode/sdk v2: the integration only describes tools for the model and maps arguments to SDK calls.

Install

pi install npm:@dominusnode/pi-extension
# or, as a plain dependency: npm install @dominusnode/pi-extension@2

Configure

export DOMINUSNODE_API_KEY=dn_live_...          # required for account tools
export DOMINUSNODE_BASE_URL=https://api.dominusnode.com   # optional
export DOMINUSNODE_PROXY_HOST=proxy.dominusnode.com       # optional
export DOMINUSNODE_PROXY_URL=https://proxy.dominusnode.com:8443  # optional; TLS proxy

Usage

package.json declares pi.extensions (./dist/index.js) and pi.skills (./skills). The default export dominusNodeExtension(pi) calls pi.registerTool({ name, label, description, parameters, execute }) for each tool, with TypeBox (typebox 1.x) schemas. execute(toolCallId, params, signal, onUpdate, ctx) returns { content: [{ type: "text", text }], details }.

The skill skills/use-dominus-proxy.md tells the agent when and how to use the tools.

The 19 tools

Tool names are dominusnode_<name> (e.g. dominusnode_fetch).

# Tool SDK call What it does
1 fetch proxy.fetch GET/HEAD a public URL through the relay (country, ip_class, session_id, allow_http)
2 proxy_url proxy.buildUrl Proxy URL for other clients; the key is replaced by ${DOMINUSNODE_API_KEY}
3 network_policy network.policy Acceptable-use policy and node floor guarantees (public)
4 network_pricing network.pricing Live per-GB prices per IP class and node revenue shares (public)
5 network_stats network.stats Online nodes by class and country (public)
6 balance wallet.getBalance Prepaid wallet balance
7 transactions wallet.getTransactions Wallet transaction history
8 topup_crypto wallet.topUpCrypto Create a crypto top-up invoice
9 check_payment wallet.getCryptoStatus Crypto invoice status
10 usage usage.get Bandwidth/cost summary for a date range
11 active_sessions sessions.getActive Open relay sessions
12 report_session sessions.report Report a misbehaving exit node
13 node_list nodes.list Your contributed relay nodes
14 node_tier nodes.tier Your node-operator tier and progress
15 node_setup_guide static How to earn by contributing an IP with the node agent
16 credits_balance credits.balance Node earnings (pending/available/frozen)
17 credits_convert none (signed flow) Points to the MCP server or SDK (needs a wallet signature)
18 payouts_list payouts.list Payout history
19 x402_info x402.getInfo x402 micropayment info (public)

Security is enforced by @dominusnode/sdk: SSRF and DNS-rebinding checks on every resolved address, GET/HEAD only, ports 80/443, no redirects, 10 MB cap, OFAC countries (CU, IR, KP, RU, SY) refused, plaintext http:// only with allow_http (visible to the exit node). Every error and result is scrubbed of dn_live_/dn_test_/dn_node_/dn_proxy_ keys and JWTs. The API key is read from DOMINUSNODE_API_KEY (or the framework's credentials store) and is never a tool argument or part of a tool result.

Prices are never hardcoded: ask the agent to call network_pricing.

Signed flows (node registration, withdrawals, payout wallet) are not exposed as LLM tools. Use the DominusNode MCP server or @dominusnode/sdk with a local signer key file.

Upgrading from 1.x

2.0 is a breaking release. Removed: Stripe/PayPal top-ups, plans, slots, email/password and MFA flows, API key / team / agentic-wallet management tools, dc-/residential- pool prefixes, hardcoded $/GB prices and the integration's own HTTP/SSRF code. Exit selection is now country + ip_class (residential, dc, mobile) on the relay network.