@dominusnode/pi-extension 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +1 -0
  2. package/README.md +63 -34
  3. package/dist/index.d.ts +1 -1
  4. package/dist/index.js +471 -32
  5. package/dist/toolkit.d.ts +38 -1
  6. package/dist/toolkit.js +784 -54
  7. package/package.json +3 -1
  8. package/skills/use-dominus-proxy.md +37 -31
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dominusnode/pi-extension",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "description": "Dominus Node pi-mono extension — 26 tools for rotating proxy, wallet, agentic wallets, teams, and payments",
5
5
  "keywords": [
6
6
  "pi-package",
@@ -29,11 +29,13 @@
29
29
  },
30
30
  "scripts": {
31
31
  "build": "tsc",
32
+ "prepare": "npm run build",
32
33
  "test": "vitest run",
33
34
  "lint": "tsc --noEmit"
34
35
  },
35
36
  "devDependencies": {
36
37
  "@sinclair/typebox": "^0.34.0",
38
+ "@types/node": "^22.0.0",
37
39
  "typescript": "^5.4.0",
38
40
  "vitest": "^1.6.0"
39
41
  },
package/skills/use-dominus-proxy.md CHANGED
@@ -22,64 +22,69 @@ export DOMINUSNODE_API_KEY="dn_live_your_key_here"
22
22
 
23
23
  The Dominus Node extension registers these tools automatically:
24
24
 
25
- | Tool | Purpose |
26
- |------|---------|
27
- | `dominusnode_proxied_fetch` | Fetch a URL through rotating IPs |
28
- | `dominusnode_check_balance` | Get wallet balance |
29
- | `dominusnode_check_usage` | Bandwidth usage stats |
30
- | `dominusnode_get_proxy_config` | Proxy endpoint details |
31
- | `dominusnode_list_sessions` | Active proxy sessions |
32
- | `dominusnode_create_agentic_wallet` | Create agent sub-wallet |
33
- | `dominusnode_fund_agentic_wallet` | Fund agent sub-wallet |
34
- | `dominusnode_check_agentic_balance` | Sub-wallet balance |
35
- | `dominusnode_list_agentic_wallets` | All sub-wallets |
36
- | `dominusnode_agentic_transactions` | Sub-wallet transaction history |
37
- | `dominusnode_freeze_agentic_wallet` | Freeze sub-wallet |
38
- | `dominusnode_unfreeze_agentic_wallet` | Unfreeze sub-wallet |
39
- | `dominusnode_delete_agentic_wallet` | Delete sub-wallet |
40
- | `dominusnode_create_team` | Create team with shared wallet |
41
- | `dominusnode_list_teams` | List teams |
42
- | `dominusnode_team_details` | Team details and balance |
43
- | `dominusnode_team_fund` | Fund team wallet |
44
- | `dominusnode_team_create_api_key` | Create team API key |
45
- | `dominusnode_team_usage` | Team bandwidth stats |
46
- | `dominusnode_update_team` | Update team settings |
47
- | `dominusnode_update_team_member_role` | Change member role |
48
- | `dominusnode_topup_paypal` | Top up via PayPal |
49
- | `dominusnode_topup_stripe` | Top up via Stripe |
50
- | `dominusnode_topup_crypto` | Top up via crypto (BTC/ETH/USDC/...) |
51
- | `dominusnode_x402_info` | x402 micropayment config |
52
- | `dominusnode_update_wallet_policy` | Set spending limits/domain restrictions |
25
+ | Tool | Purpose |
26
+ | ------------------------------------- | --------------------------------------- |
27
+ | `dominusnode_proxied_fetch` | Fetch a URL through rotating IPs |
28
+ | `dominusnode_check_balance` | Get wallet balance |
29
+ | `dominusnode_check_usage` | Bandwidth usage stats |
30
+ | `dominusnode_get_proxy_config` | Proxy endpoint details |
31
+ | `dominusnode_list_sessions` | Active proxy sessions |
32
+ | `dominusnode_create_agentic_wallet` | Create agent sub-wallet |
33
+ | `dominusnode_fund_agentic_wallet` | Fund agent sub-wallet |
34
+ | `dominusnode_check_agentic_balance` | Sub-wallet balance |
35
+ | `dominusnode_list_agentic_wallets` | All sub-wallets |
36
+ | `dominusnode_agentic_transactions` | Sub-wallet transaction history |
37
+ | `dominusnode_freeze_agentic_wallet` | Freeze sub-wallet |
38
+ | `dominusnode_unfreeze_agentic_wallet` | Unfreeze sub-wallet |
39
+ | `dominusnode_delete_agentic_wallet` | Delete sub-wallet |
40
+ | `dominusnode_create_team` | Create team with shared wallet |
41
+ | `dominusnode_list_teams` | List teams |
42
+ | `dominusnode_team_details` | Team details and balance |
43
+ | `dominusnode_team_fund` | Fund team wallet |
44
+ | `dominusnode_team_create_api_key` | Create team API key |
45
+ | `dominusnode_team_usage` | Team bandwidth stats |
46
+ | `dominusnode_update_team` | Update team settings |
47
+ | `dominusnode_update_team_member_role` | Change member role |
48
+ | `dominusnode_topup_paypal` | Top up via PayPal |
49
+ | `dominusnode_topup_stripe` | Top up via Stripe |
50
+ | `dominusnode_topup_crypto` | Top up via crypto (BTC/ETH/USDC/...) |
51
+ | `dominusnode_x402_info` | x402 micropayment config |
52
+ | `dominusnode_update_wallet_policy` | Set spending limits/domain restrictions |
53
53
 
54
54
  ## Direct Proxy Usage (via bash tool)
55
55
 
56
56
  If you prefer to use curl directly through the proxy:
57
57
 
58
58
  ### Datacenter Pool ($3/GB — fastest)
59
+
59
60
  ```bash
60
61
  curl -x "http://dc-country-US:${DOMINUSNODE_API_KEY}@proxy.dominusnode.com:8080" \
61
62
  "https://target-site.com/page"
62
63
  ```
63
64
 
64
65
  ### Residential Pool ($5/GB — appears as regular user)
66
+
65
67
  ```bash
66
68
  curl -x "http://residential-country-GB:${DOMINUSNODE_API_KEY}@proxy.dominusnode.com:8080" \
67
69
  "https://target-site.com/page"
68
70
  ```
69
71
 
70
72
  ### Auto Pool (system chooses best)
73
+
71
74
  ```bash
72
75
  curl -x "http://auto:${DOMINUSNODE_API_KEY}@proxy.dominusnode.com:8080" \
73
76
  "https://target-site.com/page"
74
77
  ```
75
78
 
76
79
  ## SOCKS5 Proxy
80
+
77
81
  ```bash
78
82
  curl --socks5 "socks5://auto:${DOMINUSNODE_API_KEY}@proxy.dominusnode.com:1080" \
79
83
  "https://target-site.com/page"
80
84
  ```
81
85
 
82
86
  ## Python (requests library)
87
+
83
88
  ```python
84
89
  import os
85
90
  proxies = {
@@ -92,6 +97,7 @@ resp = requests.get("https://target-site.com", proxies=proxies, timeout=30)
92
97
  ## Agentic Wallet Pattern (for swarm sub-agents)
93
98
 
94
99
  Give each sub-agent its own wallet with a spending cap:
100
+
95
101
  ```
96
102
  1. dominusnode_create_agentic_wallet(label="agent-1", spendingLimitCents=500)
97
103
  2. dominusnode_fund_agentic_wallet(walletId=<id>, amountCents=1000)
@@ -102,9 +108,9 @@ Give each sub-agent its own wallet with a spending cap:
102
108
 
103
109
  ## Pricing
104
110
 
105
- | Pool | Price | Best for |
106
- |------|-------|---------|
107
- | Datacenter | $3.00/GB | Fast scraping, APIs, speed-sensitive tasks |
111
+ | Pool | Price | Best for |
112
+ | ----------- | -------- | -------------------------------------------- |
113
+ | Datacenter | $3.00/GB | Fast scraping, APIs, speed-sensitive tasks |
108
114
  | Residential | $5.00/GB | Bypassing geo-blocks, appearing as real user |
109
115
 
110
116
  ## Security Notes