shll-skills 5.5.3 → 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 +2 -2
  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 +1462 -1525
  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 +7 -1985
  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
@@ -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.