@byreal-io/byreal-cli-realclaw 0.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/package.json ADDED
@@ -0,0 +1,76 @@
1
+ {
2
+ "name": "@byreal-io/byreal-cli-realclaw",
3
+ "version": "0.3.0",
4
+ "description": "AI-native CLI for Byreal CLMM DEX on Solana",
5
+ "type": "module",
6
+ "main": "dist/index.cjs",
7
+ "bin": {
8
+ "byreal-cli": "dist/index.cjs"
9
+ },
10
+ "homepage": "https://github.com/byreal-git/byreal-agent-skills",
11
+ "repository": {
12
+ "type": "git",
13
+ "url": "https://github.com/byreal-git/byreal-agent-skills.git"
14
+ },
15
+ "scripts": {
16
+ "build": "node scripts/build.mjs",
17
+ "dev": "tsx src/index.ts",
18
+ "start": "node dist/index.js",
19
+ "typecheck": "tsc --noEmit",
20
+ "lint": "eslint src --ext .ts",
21
+ "lint:fix": "eslint src --ext .ts --fix",
22
+ "test": "vitest",
23
+ "test:run": "vitest run",
24
+ "clean": "rm -rf dist",
25
+ "prepublishOnly": "npm run build",
26
+ "postversion": "npm publish && git push && git push --tags"
27
+ },
28
+ "keywords": [
29
+ "byreal",
30
+ "solana",
31
+ "clmm",
32
+ "dex",
33
+ "cli",
34
+ "defi",
35
+ "liquidity"
36
+ ],
37
+ "author": "Byreal Team (https://github.com/byreal-git)",
38
+ "license": "MIT",
39
+ "publishConfig": {
40
+ "access": "public"
41
+ },
42
+ "engines": {
43
+ "node": ">=18.0.0"
44
+ },
45
+ "files": [
46
+ "dist/index.cjs",
47
+ "skills/"
48
+ ],
49
+ "devDependencies": {
50
+ "@coral-xyz/anchor": "0.31.1",
51
+ "@solana/buffer-layout": "4.0.1",
52
+ "@solana/spl-memo": "0.2.5",
53
+ "@solana/spl-token": "0.4.13",
54
+ "@solana/web3.js": "1.98.4",
55
+ "@types/bn.js": "5.2.0",
56
+ "@types/node": "20.19.35",
57
+ "bn.js": "5.2.3",
58
+ "bs58": "6.0.0",
59
+ "chalk": "5.6.2",
60
+ "cli-table3": "0.6.5",
61
+ "commander": "12.1.0",
62
+ "decimal.js": "10.6.0",
63
+ "dotenv": "16.6.1",
64
+ "esbuild": "0.24.2",
65
+ "eslint": "9.39.3",
66
+ "ky": "1.14.3",
67
+ "lodash-es": "4.17.23",
68
+ "prettier": "3.8.1",
69
+ "tsx": "4.21.0",
70
+ "typescript": "5.9.3",
71
+ "vitest": "2.1.9"
72
+ },
73
+ "dependencies": {
74
+ "@byreal-io/byreal-clmm-sdk": "^0.2.2"
75
+ }
76
+ }
@@ -0,0 +1,67 @@
1
+ ---
2
+ name: byreal-cli
3
+ description: "Byreal DEX (Solana) all-in-one CLI: query pools/tokens/TVL, analyze pool APR & risk, open/close/claim CLMM positions, token swap, wallet & balance management. Use when user mentions Byreal, LP, liquidity, pools, DeFi positions, token swap, or Solana DEX operations."
4
+ metadata:
5
+ openclaw:
6
+ homepage: https://github.com/byreal-git/byreal-agent-skills
7
+ requires:
8
+ bins:
9
+ - byreal-cli
10
+ config: []
11
+ install:
12
+ - kind: node
13
+ package: "@byreal-io/byreal-cli-realclaw"
14
+ global: true
15
+ ---
16
+
17
+ # Byreal LP Management
18
+
19
+ ## Get Full Documentation
20
+
21
+ Always run these commands first to get complete, up-to-date documentation:
22
+
23
+ ```bash
24
+ # Complete documentation (commands, parameters, workflows, constraints)
25
+ byreal-cli skill
26
+
27
+ # Structured capability discovery (all capabilities with params)
28
+ byreal-cli catalog list
29
+
30
+ # Detailed parameter info for a specific capability
31
+ byreal-cli catalog show <capability-id>
32
+ ```
33
+
34
+ ## Installation
35
+
36
+ ```bash
37
+ # Check if already installed
38
+ which byreal-cli && byreal-cli --version
39
+
40
+ # Install
41
+ npm install -g @byreal-io/byreal-cli-realclaw
42
+ ```
43
+
44
+ ## Check for Updates
45
+
46
+ ```bash
47
+ byreal-cli update check
48
+ ```
49
+
50
+ If an update is available:
51
+
52
+ ```bash
53
+ byreal-cli update install
54
+ ```
55
+
56
+ ## Credentials & Permissions
57
+
58
+ - **Read-only commands** (pool, token, tvl, stats): No wallet required
59
+ - **Write commands** (swap, position open/close/claim): All write commands require `--wallet-address <address>` global option. No local keypair is needed.
60
+
61
+ ## Hard Constraints
62
+
63
+ 1. **`-o json` only for parsing** — when showing results to the user, **omit it** and let the CLI's built-in tables/charts render directly. Never fetch JSON then re-draw charts yourself.
64
+ 2. **Never truncate on-chain data** — always display the FULL string for: transaction signatures (txid), mint addresses, pool addresses, NFT addresses, wallet addresses. Never use `xxx...yyy` abbreviation.
65
+ 3. **Default mode outputs unsigned base64 transactions.** Use `--dry-run` for preview.
66
+ 4. **Large amounts (>$1000)** require explicit confirmation
67
+ 5. **High slippage (>200 bps)** must warn user