xno-skills 2.8.4 → 2.8.5
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/README.md +8 -8
- package/dist/cjs/version.d.ts +2 -2
- package/dist/cjs/version.js +1 -1
- package/dist/esm/.xno-mcp/requests.json +6 -6
- package/dist/esm/version.d.ts +2 -2
- package/dist/esm/version.js +1 -1
- package/package.json +2 -2
- package/skills/nano/SKILL.md +23 -23
package/README.md
CHANGED
|
@@ -31,7 +31,7 @@ Available skills:
|
|
|
31
31
|
## CLI
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
npm install -g xno-skills@
|
|
34
|
+
npm install -g xno-skills@2.8.5
|
|
35
35
|
xno-skills --help
|
|
36
36
|
```
|
|
37
37
|
|
|
@@ -89,7 +89,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
|
|
|
89
89
|
"mcpServers": {
|
|
90
90
|
"nano": {
|
|
91
91
|
"command": "npx",
|
|
92
|
-
"args": ["-y", "-p", "xno-skills@
|
|
92
|
+
"args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
|
|
93
93
|
}
|
|
94
94
|
}
|
|
95
95
|
}
|
|
@@ -105,7 +105,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
|
|
|
105
105
|
codex mcp add nano \
|
|
106
106
|
-c sandbox_mode="danger-full-access" \
|
|
107
107
|
-c 'sandbox_permissions=["network-access"]' \
|
|
108
|
-
-- npx -y -p xno-skills@
|
|
108
|
+
-- npx -y -p xno-skills@2.8.5 xno-mcp
|
|
109
109
|
```
|
|
110
110
|
</details>
|
|
111
111
|
|
|
@@ -117,7 +117,7 @@ codex mcp add nano \
|
|
|
117
117
|
"mcpServers": {
|
|
118
118
|
"nano": {
|
|
119
119
|
"command": "npx",
|
|
120
|
-
"args": ["-y", "-p", "xno-skills@
|
|
120
|
+
"args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
|
|
121
121
|
}
|
|
122
122
|
}
|
|
123
123
|
}
|
|
@@ -133,7 +133,7 @@ codex mcp add nano \
|
|
|
133
133
|
"mcp": {
|
|
134
134
|
"nano": {
|
|
135
135
|
"type": "local",
|
|
136
|
-
"command": ["npx", "-y", "-p", "xno-skills@
|
|
136
|
+
"command": ["npx", "-y", "-p", "xno-skills@2.8.5", "xno-mcp"],
|
|
137
137
|
"enabled": true
|
|
138
138
|
}
|
|
139
139
|
}
|
|
@@ -149,7 +149,7 @@ codex mcp add nano \
|
|
|
149
149
|
"mcpServers": {
|
|
150
150
|
"nano": {
|
|
151
151
|
"command": "npx",
|
|
152
|
-
"args": ["-y", "-p", "xno-skills@
|
|
152
|
+
"args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
|
|
153
153
|
}
|
|
154
154
|
}
|
|
155
155
|
}
|
|
@@ -164,7 +164,7 @@ codex mcp add nano \
|
|
|
164
164
|
"mcpServers": {
|
|
165
165
|
"nano": {
|
|
166
166
|
"command": "npx",
|
|
167
|
-
"args": ["-y", "-p", "xno-skills@
|
|
167
|
+
"args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
|
|
168
168
|
}
|
|
169
169
|
}
|
|
170
170
|
}
|
|
@@ -180,7 +180,7 @@ codex mcp add nano \
|
|
|
180
180
|
"nano": {
|
|
181
181
|
"type": "stdio",
|
|
182
182
|
"command": "npx",
|
|
183
|
-
"args": ["-y", "-p", "xno-skills@
|
|
183
|
+
"args": ["-y", "-p", "xno-skills@2.8.5", "xno-mcp"]
|
|
184
184
|
}
|
|
185
185
|
}
|
|
186
186
|
}
|
package/dist/cjs/version.d.ts
CHANGED
package/dist/cjs/version.js
CHANGED
|
@@ -1,27 +1,27 @@
|
|
|
1
1
|
{
|
|
2
2
|
"requests": [
|
|
3
3
|
{
|
|
4
|
-
"id": "
|
|
4
|
+
"id": "mos8z0lk5wb2gk",
|
|
5
5
|
"owsWalletId": "A",
|
|
6
6
|
"accountIndex": 0,
|
|
7
7
|
"address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
|
|
8
8
|
"amountRaw": "10000000000000000000000000000",
|
|
9
9
|
"reason": "explicit wallet test",
|
|
10
10
|
"status": "pending",
|
|
11
|
-
"createdAt": "2026-05-05T06:
|
|
12
|
-
"updatedAt": "2026-05-05T06:
|
|
11
|
+
"createdAt": "2026-05-05T06:28:29.768Z",
|
|
12
|
+
"updatedAt": "2026-05-05T06:28:29.768Z",
|
|
13
13
|
"receivedBlocks": []
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
|
-
"id": "
|
|
16
|
+
"id": "mos8z0mppvtzd5",
|
|
17
17
|
"owsWalletId": "A",
|
|
18
18
|
"accountIndex": 0,
|
|
19
19
|
"address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
|
|
20
20
|
"amountRaw": "500000000000000000000000000000",
|
|
21
21
|
"reason": "status check test",
|
|
22
22
|
"status": "pending",
|
|
23
|
-
"createdAt": "2026-05-05T06:
|
|
24
|
-
"updatedAt": "2026-05-05T06:
|
|
23
|
+
"createdAt": "2026-05-05T06:28:29.809Z",
|
|
24
|
+
"updatedAt": "2026-05-05T06:28:29.809Z",
|
|
25
25
|
"receivedBlocks": []
|
|
26
26
|
}
|
|
27
27
|
]
|
package/dist/esm/version.d.ts
CHANGED
package/dist/esm/version.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "xno-skills",
|
|
3
|
-
"version": "2.8.
|
|
3
|
+
"version": "2.8.5",
|
|
4
4
|
"description": "XNO CLI - Interact with Nano (XNO)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/cjs/index.js",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
],
|
|
25
25
|
"scripts": {
|
|
26
26
|
"preversion": "npm test",
|
|
27
|
-
"version": "node scripts/update-version.js && git add src/version.ts skills/nano/SKILL.md",
|
|
27
|
+
"version": "node scripts/update-version.js && git add src/version.ts skills/nano/SKILL.md README.md",
|
|
28
28
|
"postversion": "node -e \"const v=require('./package.json').version; console.log('Created tag v'+v+'. Next: git push --follow-tags (GitHub Actions will publish to npm + create the GitHub Release).');\"",
|
|
29
29
|
"prebuild": "node scripts/update-version.js",
|
|
30
30
|
"prebuild:esm": "node scripts/update-version.js",
|
package/skills/nano/SKILL.md
CHANGED
|
@@ -75,16 +75,16 @@ When the environment provides `xno-mcp` tools (`wallets`, `send`, `receive`, `ba
|
|
|
75
75
|
If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage, fall back to the `xno-skills` CLI in this priority order:
|
|
76
76
|
|
|
77
77
|
```
|
|
78
|
-
1. bunx -y xno-skills@2.8.
|
|
79
|
-
2. pnpm dlx xno-skills@2.8.
|
|
80
|
-
3. npx -y xno-skills@2.8.
|
|
78
|
+
1. bunx -y xno-skills@2.8.5 <command>
|
|
79
|
+
2. pnpm dlx xno-skills@2.8.5 <command>
|
|
80
|
+
3. npx -y xno-skills@2.8.5 <command>
|
|
81
81
|
```
|
|
82
82
|
|
|
83
83
|
Do **not** assume `xno-skills` is installed globally. Always use one of the above forms with `@latest` to get critical bugfixes and to prevent interactive prompts from freezing.
|
|
84
84
|
|
|
85
85
|
Before guessing a subcommand, run `--help`:
|
|
86
86
|
```bash
|
|
87
|
-
bunx -y xno-skills@2.8.
|
|
87
|
+
bunx -y xno-skills@2.8.5 --help
|
|
88
88
|
```
|
|
89
89
|
|
|
90
90
|
### 3. Wallet lifecycle → `ows` skill only
|
|
@@ -108,7 +108,7 @@ For wallet **create, import, rename, or delete**: delegate to the `ows` skill. D
|
|
|
108
108
|
- **Proactivity on pending funds**: If you see pending funds during any balance check, call `receive` immediately. Do not wait for the user to ask.
|
|
109
109
|
- **Persistence on "Account not found"**: This is normal for a brand-new, unopened account. Continue — `receive` will build the open block automatically. Never conclude you are unauthorized or that OWS cannot sign Nano blocks.
|
|
110
110
|
- **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
|
|
111
|
-
- **Supply chain**: Only use `xno-skills@2.8.
|
|
111
|
+
- **Supply chain**: Only use `xno-skills@2.8.5` and `@open-wallet-standard/core`. No other npm packages.
|
|
112
112
|
- **Stop-loss**: If you have made 5 tool calls without completing the operation, stop and report what you tried, what failed, and ask for guidance. Hard limits: max 3 retries of the same failing tool; max 2 `config_set` RPC endpoint switches.
|
|
113
113
|
|
|
114
114
|
---
|
|
@@ -139,8 +139,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
|
|
|
139
139
|
|
|
140
140
|
**Via CLI:**
|
|
141
141
|
```bash
|
|
142
|
-
bunx -y xno-skills@2.8.
|
|
143
|
-
bunx -y xno-skills@2.8.
|
|
142
|
+
bunx -y xno-skills@2.8.5 balance --wallet "my-wallet"
|
|
143
|
+
bunx -y xno-skills@2.8.5 rpc account-balance <address> --json
|
|
144
144
|
```
|
|
145
145
|
|
|
146
146
|
**Public zero-config RPC nodes** (used automatically by xno-skills defaults):
|
|
@@ -168,7 +168,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
|
|
|
168
168
|
|
|
169
169
|
**Via CLI:**
|
|
170
170
|
```bash
|
|
171
|
-
bunx -y xno-skills@2.8.
|
|
171
|
+
bunx -y xno-skills@2.8.5 receive --wallet "my-wallet"
|
|
172
172
|
```
|
|
173
173
|
|
|
174
174
|
**Unopened account — explicit representative:**
|
|
@@ -198,7 +198,7 @@ The account must be opened (have a receive block) and have sufficient balance.
|
|
|
198
198
|
|
|
199
199
|
**Via CLI:**
|
|
200
200
|
```bash
|
|
201
|
-
bunx -y xno-skills@2.8.
|
|
201
|
+
bunx -y xno-skills@2.8.5 send --wallet "my-wallet" --destination "nano_..." --amount-xno 0.01
|
|
202
202
|
```
|
|
203
203
|
|
|
204
204
|
**Validate the destination address first** (see Address Validation section).
|
|
@@ -305,13 +305,13 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
|
|
|
305
305
|
**Via CLI:**
|
|
306
306
|
```bash
|
|
307
307
|
# Address only
|
|
308
|
-
bunx -y xno-skills@2.8.
|
|
308
|
+
bunx -y xno-skills@2.8.5 qr nano_1abc...
|
|
309
309
|
|
|
310
310
|
# With amount
|
|
311
|
-
bunx -y xno-skills@2.8.
|
|
311
|
+
bunx -y xno-skills@2.8.5 qr nano_1abc... --amount-xno 1.5
|
|
312
312
|
|
|
313
313
|
# JSON output (recommended for agents — avoids stdout truncation)
|
|
314
|
-
bunx -y xno-skills@2.8.
|
|
314
|
+
bunx -y xno-skills@2.8.5 qr nano_1abc... --amount-xno 1.5 --json
|
|
315
315
|
```
|
|
316
316
|
|
|
317
317
|
> **CRITICAL — stdout truncation**: Agents often have stdout truncated (e.g. `<truncated 14 lines>`). To display a full QR code:
|
|
@@ -342,7 +342,7 @@ All validation is **offline** — no network required.
|
|
|
342
342
|
|
|
343
343
|
**Via CLI:**
|
|
344
344
|
```bash
|
|
345
|
-
bunx -y xno-skills@2.8.
|
|
345
|
+
bunx -y xno-skills@2.8.5 validate nano_1abc...
|
|
346
346
|
```
|
|
347
347
|
|
|
348
348
|
**Always validate before sending XNO to an untrusted address.**
|
|
@@ -367,10 +367,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
|
|
|
367
367
|
|
|
368
368
|
**Via CLI:**
|
|
369
369
|
```bash
|
|
370
|
-
bunx -y xno-skills@2.8.
|
|
371
|
-
bunx -y xno-skills@2.8.
|
|
372
|
-
bunx -y xno-skills@2.8.
|
|
373
|
-
bunx -y xno-skills@2.8.
|
|
370
|
+
bunx -y xno-skills@2.8.5 convert 1 xno # all units
|
|
371
|
+
bunx -y xno-skills@2.8.5 convert 1 knano
|
|
372
|
+
bunx -y xno-skills@2.8.5 convert 1000000000000000000000000000000 raw
|
|
373
|
+
bunx -y xno-skills@2.8.5 convert 1 xno --json
|
|
374
374
|
```
|
|
375
375
|
|
|
376
376
|
---
|
|
@@ -394,20 +394,20 @@ Present the user with this command to run locally:
|
|
|
394
394
|
|
|
395
395
|
```bash
|
|
396
396
|
# Sign — run this yourself, replacing the placeholder with your actual key
|
|
397
|
-
bunx -y xno-skills@2.8.
|
|
397
|
+
bunx -y xno-skills@2.8.5 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
|
|
398
398
|
|
|
399
399
|
# Sign with JSON output
|
|
400
|
-
bunx -y xno-skills@2.8.
|
|
400
|
+
bunx -y xno-skills@2.8.5 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
|
|
401
401
|
```
|
|
402
402
|
|
|
403
403
|
For verify, the agent *can* run this directly (no secret material involved):
|
|
404
404
|
|
|
405
405
|
```bash
|
|
406
406
|
# Verify
|
|
407
|
-
bunx -y xno-skills@2.8.
|
|
407
|
+
bunx -y xno-skills@2.8.5 verify <nano_address> "<message>" <signature-hex>
|
|
408
408
|
|
|
409
409
|
# Verify with JSON output
|
|
410
|
-
bunx -y xno-skills@2.8.
|
|
410
|
+
bunx -y xno-skills@2.8.5 verify <nano_address> "<message>" <signature-hex> --json
|
|
411
411
|
```
|
|
412
412
|
|
|
413
413
|
**NOMS standard (ORIS-001)**: Signatures are computed over a binary payload with a magic header, ensuring a valid signature cannot be misinterpreted as a Nano transaction block.
|
|
@@ -468,7 +468,7 @@ PoW input:
|
|
|
468
468
|
|
|
469
469
|
To probe whether an RPC endpoint supports remote `work_generate`:
|
|
470
470
|
```bash
|
|
471
|
-
bunx -y xno-skills@2.8.
|
|
471
|
+
bunx -y xno-skills@2.8.5 rpc probe-caps <url>
|
|
472
472
|
```
|
|
473
473
|
Never use `curl` to probe this.
|
|
474
474
|
|
|
@@ -484,7 +484,7 @@ Never use `curl` to probe this.
|
|
|
484
484
|
{ "name": "change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
|
|
485
485
|
```
|
|
486
486
|
```bash
|
|
487
|
-
bunx -y xno-skills@2.8.
|
|
487
|
+
bunx -y xno-skills@2.8.5 change-rep --wallet "my-wallet" --representative "nano_..."
|
|
488
488
|
```
|
|
489
489
|
|
|
490
490
|
### Data Representations
|