shll-skills 5.5.2 → 5.6.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 (43) hide show
  1. package/.env.example +2 -2
  2. package/README.md +1 -1
  3. package/SKILL.md +4 -4
  4. package/dist/chunk-E6V6FKRK.mjs +1196 -0
  5. package/dist/index.js +1122 -2290
  6. package/dist/index.mjs +689 -2408
  7. package/dist/mcp.d.mts +2 -1
  8. package/dist/mcp.d.ts +2 -1
  9. package/dist/mcp.js +1401 -1464
  10. package/dist/mcp.mjs +980 -1648
  11. package/package.json +1 -1
  12. package/src/commands/agent.ts +128 -0
  13. package/src/commands/calldata.ts +49 -0
  14. package/src/commands/defi.ts +191 -0
  15. package/src/commands/fourmeme.ts +149 -0
  16. package/src/commands/index.ts +20 -0
  17. package/src/commands/info.ts +150 -0
  18. package/src/commands/lending.ts +100 -0
  19. package/src/commands/setup.ts +76 -0
  20. package/src/commands/transfer.ts +62 -0
  21. package/src/commands/utils.ts +26 -0
  22. package/src/index.ts +13 -3032
  23. package/src/mcp.ts +5 -1983
  24. package/src/shared/abi.ts +213 -0
  25. package/src/shared/clients.ts +72 -0
  26. package/src/shared/constants.ts +40 -0
  27. package/src/shared/errors.ts +58 -0
  28. package/src/shared/index.ts +28 -0
  29. package/src/shared/indexer.ts +122 -0
  30. package/src/shared/schemas.ts +27 -0
  31. package/src/shared/security.ts +283 -0
  32. package/src/shared/tokens.ts +80 -0
  33. package/src/shared/types.ts +40 -0
  34. package/src/tools/agent.ts +210 -0
  35. package/src/tools/calldata.ts +123 -0
  36. package/src/tools/defi.ts +188 -0
  37. package/src/tools/fourmeme.ts +204 -0
  38. package/src/tools/index.ts +20 -0
  39. package/src/tools/info.ts +170 -0
  40. package/src/tools/lending.ts +90 -0
  41. package/src/tools/setup.ts +115 -0
  42. package/src/tools/transfer.ts +70 -0
  43. package/dist/chunk-EUGNHCIP.mjs +0 -502
package/.env.example CHANGED
@@ -5,5 +5,5 @@
5
5
  RUNNER_PRIVATE_KEY=0x_YOUR_PRIVATE_KEY_HERE
6
6
 
7
7
  # ── Optional ─────────────────────────────────────────────
8
- # BSC RPC endpoint (default: https://bsc-dataseed1.binance.org)
9
- # SHLL_RPC=https://bsc-dataseed.binance.org
8
+ # BSC RPC endpoint. A private RPC (QuickNode, Alchemy, GetBlock) is recommended for reliability.
9
+ # SHLL_RPC=https://your-private-bsc-rpc.example.com
package/README.md CHANGED
@@ -173,7 +173,7 @@ AI Agent -> CLI/MCP -> PolicyClient.validate() -> PolicyGuard (on-chain) -> vaul
173
173
  | Variable | Required | Description |
174
174
  |----------|----------|-------------|
175
175
  | `RUNNER_PRIVATE_KEY` | Yes | Operator wallet key (~$1 BNB for gas) |
176
- | `SHLL_RPC` | No | BSC RPC URL override (default: public BSC RPC) |
176
+ | `SHLL_RPC` | No | BSC RPC URL override. Recommended: use a private RPC (e.g. QuickNode, Alchemy, GetBlock) for better reliability and speed |
177
177
 
178
178
  > **Note:** Contract addresses (AgentNFA, PolicyGuard) are hardcoded for security reasons. Override env vars are intentionally not supported to prevent supply-chain attacks.
179
179
 
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 and users only need to chat.
4
- version: 5.5.1
4
+ version: 5.5.3
5
5
  author: SHLL Team
6
6
  website: https://shll.run
7
7
  twitter: https://twitter.com/shllrun
@@ -48,7 +48,7 @@ On-chain guardrails:
48
48
  - Spending limits, cooldowns, whitelist rules, and protocol rules are enforced on-chain.
49
49
  - Raw calldata path is guarded by recipient safety checks before on-chain execution.
50
50
 
51
- ## Current Critical Constraints (v5.5.1)
51
+ ## Current Critical Constraints (v5.5.3)
52
52
 
53
53
  1. `init` command is disabled. Do not use it.
54
54
  2. CLI `raw` requires `--i-understand-the-risk`.
@@ -68,9 +68,9 @@ npm install -g shll-skills --registry https://registry.npmjs.org
68
68
  export RUNNER_PRIVATE_KEY="0x..."
69
69
  ```
70
70
 
71
- 3. Optional custom RPC:
71
+ 3. Optional — use a private RPC for better reliability and speed:
72
72
  ```bash
73
- export SHLL_RPC="https://bsc-dataseed1.binance.org"
73
+ export SHLL_RPC="https://your-private-bsc-rpc.example.com"
74
74
  ```
75
75
 
76
76
  4. Ensure operator wallet has small BNB balance for gas.