@dominusnode/pi-extension 1.2.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.
- package/CHANGELOG.md +1 -0
- package/README.md +60 -58
- package/dist/index.js +150 -42
- package/dist/toolkit.d.ts +6 -0
- package/dist/toolkit.js +309 -49
- package/package.json +3 -1
- package/skills/use-dominus-proxy.md +37 -31
|
@@ -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
|
|
26
|
-
|
|
27
|
-
| `dominusnode_proxied_fetch`
|
|
28
|
-
| `dominusnode_check_balance`
|
|
29
|
-
| `dominusnode_check_usage`
|
|
30
|
-
| `dominusnode_get_proxy_config`
|
|
31
|
-
| `dominusnode_list_sessions`
|
|
32
|
-
| `dominusnode_create_agentic_wallet`
|
|
33
|
-
| `dominusnode_fund_agentic_wallet`
|
|
34
|
-
| `dominusnode_check_agentic_balance`
|
|
35
|
-
| `dominusnode_list_agentic_wallets`
|
|
36
|
-
| `dominusnode_agentic_transactions`
|
|
37
|
-
| `dominusnode_freeze_agentic_wallet`
|
|
38
|
-
| `dominusnode_unfreeze_agentic_wallet` | Unfreeze sub-wallet
|
|
39
|
-
| `dominusnode_delete_agentic_wallet`
|
|
40
|
-
| `dominusnode_create_team`
|
|
41
|
-
| `dominusnode_list_teams`
|
|
42
|
-
| `dominusnode_team_details`
|
|
43
|
-
| `dominusnode_team_fund`
|
|
44
|
-
| `dominusnode_team_create_api_key`
|
|
45
|
-
| `dominusnode_team_usage`
|
|
46
|
-
| `dominusnode_update_team`
|
|
47
|
-
| `dominusnode_update_team_member_role` | Change member role
|
|
48
|
-
| `dominusnode_topup_paypal`
|
|
49
|
-
| `dominusnode_topup_stripe`
|
|
50
|
-
| `dominusnode_topup_crypto`
|
|
51
|
-
| `dominusnode_x402_info`
|
|
52
|
-
| `dominusnode_update_wallet_policy`
|
|
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
|
|
106
|
-
|
|
107
|
-
| Datacenter
|
|
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
|