shll-skills 5.3.1 → 5.3.3

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 (10) hide show
  1. package/.env.example +5 -11
  2. package/README.md +5 -4
  3. package/SKILL.md +3 -1
  4. package/dist/index.js +1 -1
  5. package/dist/index.mjs +1 -1
  6. package/dist/mcp.js +2 -2
  7. package/dist/mcp.mjs +2 -2
  8. package/package.json +1 -1
  9. package/src/index.ts +1 -1
  10. package/src/mcp.ts +2 -2
package/.env.example CHANGED
@@ -1,15 +1,9 @@
1
1
  # ── Required ─────────────────────────────────────────────
2
- # Private key for the operator/renter wallet.
3
- # ⚠️ This key is used for: init (rent+fund), swap, wrap, unwrap, transfer, config.
2
+ # Private key for the operator wallet (hot wallet for AI trading).
4
3
  # ⚠️ Use a DEDICATED wallet with limited funds. Never use your main wallet.
4
+ # ⚠️ This wallet can only trade within PolicyGuard limits — it CANNOT withdraw vault funds.
5
5
  RUNNER_PRIVATE_KEY=0x_YOUR_PRIVATE_KEY_HERE
6
6
 
7
- # ── Optional Overrides ───────────────────────────────────
8
- # BSC RPC endpoint (default: public BSC RPC)
9
- # RPC_URL=https://bsc-dataseed.binance.org
10
-
11
- # AgentNFA contract address (default: mainnet deployment)
12
- # NFA_ADDRESS=0x...
13
-
14
- # PolicyGuardV4 contract address (default: mainnet deployment)
15
- # GUARD_ADDRESS=0x...
7
+ # ── Optional ─────────────────────────────────────────────
8
+ # BSC RPC endpoint (default: https://bsc-dataseed1.binance.org)
9
+ # SHLL_RPC=https://bsc-dataseed.binance.org
package/README.md CHANGED
@@ -65,7 +65,7 @@ RUNNER_PRIVATE_KEY=0x... shll-mcp
65
65
 
66
66
  The server communicates via **stdio** using JSON-RPC 2.0. Send `tools/list` to discover all available tools.
67
67
 
68
- ### Available MCP Tools (22 total)
68
+ ### Available MCP Tools (24 total)
69
69
 
70
70
  | Tool | Type | Description |
71
71
  |------|------|-------------|
@@ -91,6 +91,7 @@ The server communicates via **stdio** using JSON-RPC 2.0. Send `tools/list` to d
91
91
  | `generate_wallet` | Info | Create new operator wallet (address + key) |
92
92
  | `execute_calldata` | Write | Execute raw calldata from any source through PolicyGuard |
93
93
  | `execute_calldata_batch` | Write | Execute multiple calldata actions atomically through PolicyGuard |
94
+ | `token_restriction` | Read | View token whitelist restriction status + whitelisted tokens |
94
95
 
95
96
  ---
96
97
 
@@ -172,9 +173,9 @@ AI Agent -> CLI/MCP -> PolicyClient.validate() -> PolicyGuard (on-chain) -> vaul
172
173
  | Variable | Required | Description |
173
174
  |----------|----------|-------------|
174
175
  | `RUNNER_PRIVATE_KEY` | Yes | Operator wallet key (~$1 BNB for gas) |
175
- | `SHLL_RPC` | No | BSC RPC URL override |
176
- | `SHLL_NFA` | No | AgentNFA contract override |
177
- | `SHLL_GUARD` | No | PolicyGuard contract override |
176
+ | `SHLL_RPC` | No | BSC RPC URL override (default: public BSC RPC) |
177
+
178
+ > **Note:** Contract addresses (AgentNFA, PolicyGuard) are hardcoded for security reasons. Override env vars are intentionally not supported to prevent supply-chain attacks.
178
179
 
179
180
  ## Links
180
181
 
package/SKILL.md CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: shll-run
3
3
  description: Execute DeFi transactions on BSC via SHLL AgentNFA. The AI handles all commands — users only need to chat.
4
- version: 6.0.0
4
+ version: 5.3.3
5
5
  author: SHLL Team
6
6
  website: https://shll.run
7
7
  twitter: https://twitter.com/shllrun
@@ -196,6 +196,8 @@ Supported lending tokens: **BNB, USDT, USDC, BUSD**
196
196
  | `shll-run config -k <ID> --tx-limit <BNB> --daily-limit <BNB> --cooldown <SEC>` | Tighten risk limits |
197
197
  | `shll-run status -k <ID>` | One-shot security overview (vault, operator, policies, activity) |
198
198
  | `shll-run history -k <ID> [--limit N]` | Recent transactions + policy rejections |
199
+ | `shll-run my-agents` | List all agents where current operator key is authorized |
200
+ | `shll-run token-restriction -k <ID>` | View token whitelist restriction status + whitelisted tokens |
199
201
 
200
202
  **Supported tokens:** BNB, USDC, USDT, WBNB, CAKE, ETH, BTCB, DAI, BUSD, or any 0x address.
201
203
 
package/dist/index.js CHANGED
@@ -507,7 +507,7 @@ var DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
507
507
  var DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
508
508
  var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
509
509
  var DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
510
- var DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
510
+ var DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
511
511
  var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
512
512
  var PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
513
513
  var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
package/dist/index.mjs CHANGED
@@ -19,7 +19,7 @@ var DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
19
19
  var DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
20
20
  var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
21
21
  var DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
22
- var DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
22
+ var DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
23
23
  var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
24
24
  var PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
25
25
  var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
package/dist/mcp.js CHANGED
@@ -509,7 +509,7 @@ var DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
509
509
  var DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
510
510
  var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
511
511
  var DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
512
- var DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
512
+ var DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
513
513
  var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
514
514
  var PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
515
515
  var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
@@ -709,7 +709,7 @@ function policyRejectionHelp(reason, tokenId) {
709
709
  }
710
710
  var server = new import_mcp.McpServer({
711
711
  name: "shll-defi",
712
- version: "5.3.0"
712
+ version: "5.3.3"
713
713
  });
714
714
  server.tool(
715
715
  "portfolio",
package/dist/mcp.mjs CHANGED
@@ -20,7 +20,7 @@ var DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
20
20
  var DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
21
21
  var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
22
22
  var DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
23
- var DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
23
+ var DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
24
24
  var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
25
25
  var PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
26
26
  var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
@@ -220,7 +220,7 @@ function policyRejectionHelp(reason, tokenId) {
220
220
  }
221
221
  var server = new McpServer({
222
222
  name: "shll-defi",
223
- version: "5.3.0"
223
+ version: "5.3.3"
224
224
  });
225
225
  server.tool(
226
226
  "portfolio",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shll-skills",
3
- "version": "5.3.1",
3
+ "version": "5.3.3",
4
4
  "description": "SHLL DeFi Agent — CLI + MCP Server for BSC",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
package/src/index.ts CHANGED
@@ -20,7 +20,7 @@ const DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
20
20
  const DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
21
21
  const DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
22
22
  const DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
23
- const DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
23
+ const DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
24
24
  const PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
25
25
  const PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
26
26
  const WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
package/src/mcp.ts CHANGED
@@ -36,7 +36,7 @@ const DEFAULT_NFA = "0xE98DCdbf370D7b52c9A2b88F79bEF514A5375a2b";
36
36
  const DEFAULT_GUARD = "0x25d17eA0e3Bcb8CA08a2BFE917E817AFc05dbBB3";
37
37
  const DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
38
38
  const DEFAULT_LISTING_MANAGER = "0x1f9CE85bD0FF75acc3D92eB79f1Eb472f0865071";
39
- const DEFAULT_LISTING_ID = "0x733e9d959da5c1745fa507df6b47537f0945012eff3ceb4b684cd4482f2bc4d3";
39
+ const DEFAULT_LISTING_ID = "0xdea70e684f33fe9966753d3008c8c7ddd4422e04751b2198d03d82e97affca22";
40
40
  const PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
41
41
  const PANCAKE_V3_SMART_ROUTER = "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
42
42
  const WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
@@ -266,7 +266,7 @@ function policyRejectionHelp(reason: string | undefined, tokenId: string): Recor
266
266
 
267
267
  const server = new McpServer({
268
268
  name: "shll-defi",
269
- version: "5.3.0",
269
+ version: "5.3.3",
270
270
  });
271
271
 
272
272
  // ── Tool: portfolio ─────────────────────────────────────