xno-skills 4.5.1 → 4.5.2
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 +1 -1
- package/skills/nano/SKILL.md +21 -21
package/README.md
CHANGED
|
@@ -50,7 +50,7 @@ xno-skills --help
|
|
|
50
50
|
|
|
51
51
|
To pin to the current stable release instead:
|
|
52
52
|
```bash
|
|
53
|
-
npm install -g xno-skills@4.5.
|
|
53
|
+
npm install -g xno-skills@4.5.2 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
|
|
@@ -112,7 +112,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
|
|
|
112
112
|
"mcpServers": {
|
|
113
113
|
"nano": {
|
|
114
114
|
"command": "npx",
|
|
115
|
-
"args": ["-y", "-p", "xno-skills@4.5.
|
|
115
|
+
"args": ["-y", "-p", "xno-skills@4.5.2", "xno-mcp"]
|
|
116
116
|
}
|
|
117
117
|
}
|
|
118
118
|
}
|
|
@@ -128,7 +128,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
|
|
|
128
128
|
codex mcp add nano \
|
|
129
129
|
-c sandbox_mode="danger-full-access" \
|
|
130
130
|
-c 'sandbox_permissions=["network-access"]' \
|
|
131
|
-
-- npx -y -p xno-skills@4.5.
|
|
131
|
+
-- npx -y -p xno-skills@4.5.2 xno-mcp
|
|
132
132
|
```
|
|
133
133
|
</details>
|
|
134
134
|
|
|
@@ -140,7 +140,7 @@ codex mcp add nano \
|
|
|
140
140
|
"mcpServers": {
|
|
141
141
|
"nano": {
|
|
142
142
|
"command": "npx",
|
|
143
|
-
"args": ["-y", "-p", "xno-skills@4.5.
|
|
143
|
+
"args": ["-y", "-p", "xno-skills@4.5.2", "xno-mcp"]
|
|
144
144
|
}
|
|
145
145
|
}
|
|
146
146
|
}
|
|
@@ -156,7 +156,7 @@ codex mcp add nano \
|
|
|
156
156
|
"mcp": {
|
|
157
157
|
"nano": {
|
|
158
158
|
"type": "local",
|
|
159
|
-
"command": ["npx", "-y", "-p", "xno-skills@4.5.
|
|
159
|
+
"command": ["npx", "-y", "-p", "xno-skills@4.5.2", "xno-mcp"],
|
|
160
160
|
"enabled": true
|
|
161
161
|
}
|
|
162
162
|
}
|
|
@@ -172,7 +172,7 @@ codex mcp add nano \
|
|
|
172
172
|
"mcpServers": {
|
|
173
173
|
"nano": {
|
|
174
174
|
"command": "npx",
|
|
175
|
-
"args": ["-y", "-p", "xno-skills@4.5.
|
|
175
|
+
"args": ["-y", "-p", "xno-skills@4.5.2", "xno-mcp"]
|
|
176
176
|
}
|
|
177
177
|
}
|
|
178
178
|
}
|
|
@@ -187,7 +187,7 @@ codex mcp add nano \
|
|
|
187
187
|
"mcpServers": {
|
|
188
188
|
"nano": {
|
|
189
189
|
"command": "npx",
|
|
190
|
-
"args": ["-y", "-p", "xno-skills@4.5.
|
|
190
|
+
"args": ["-y", "-p", "xno-skills@4.5.2", "xno-mcp"]
|
|
191
191
|
}
|
|
192
192
|
}
|
|
193
193
|
}
|
|
@@ -203,7 +203,7 @@ codex mcp add nano \
|
|
|
203
203
|
"nano": {
|
|
204
204
|
"type": "stdio",
|
|
205
205
|
"command": "npx",
|
|
206
|
-
"args": ["-y", "-p", "xno-skills@4.5.
|
|
206
|
+
"args": ["-y", "-p", "xno-skills@4.5.2", "xno-mcp"]
|
|
207
207
|
}
|
|
208
208
|
}
|
|
209
209
|
}
|
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": "mrsxekbj93gyki",
|
|
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-07-
|
|
12
|
-
"updatedAt": "2026-07-
|
|
11
|
+
"createdAt": "2026-07-20T07:51:32.959Z",
|
|
12
|
+
"updatedAt": "2026-07-20T07:51:32.959Z",
|
|
13
13
|
"receivedBlocks": []
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
|
-
"id": "
|
|
16
|
+
"id": "mrsxekcp1dt0jl",
|
|
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-07-
|
|
24
|
-
"updatedAt": "2026-07-
|
|
23
|
+
"createdAt": "2026-07-20T07:51:33.001Z",
|
|
24
|
+
"updatedAt": "2026-07-20T07:51:33.001Z",
|
|
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": "4.5.
|
|
3
|
+
"version": "4.5.2",
|
|
4
4
|
"description": "The Nano (XNO) toolkit for AI agents and developers. Send, receive, check balances, and manage payment requests without ever handling private keys.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/cjs/index.js",
|
package/skills/nano/SKILL.md
CHANGED
|
@@ -83,7 +83,7 @@ When the environment provides `xno-mcp` tools (`wallet_list`, `wallet_send`, `wa
|
|
|
83
83
|
|
|
84
84
|
If the client supports MCP, set it up as a "stdio" type MCP server:
|
|
85
85
|
|
|
86
|
-
npx -y -p xno-skills@4.5.
|
|
86
|
+
npx -y -p xno-skills@4.5.2 -- mcp
|
|
87
87
|
|
|
88
88
|
MCP is the primary execution path because tools, schemas, and results are structured for the client. Use the included CLI script (`xno-skills`) only as a fallback when MCP is unavailable or the client cannot attach MCP servers. MCP and the CLI target EXACTLY the same underlying code paths — two access paths, not two different products.
|
|
89
89
|
|
|
@@ -92,16 +92,16 @@ MCP is the primary execution path because tools, schemas, and results are struct
|
|
|
92
92
|
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:
|
|
93
93
|
|
|
94
94
|
```
|
|
95
|
-
1. bunx -y xno-skills@4.5.
|
|
96
|
-
2. pnpm dlx xno-skills@4.5.
|
|
97
|
-
3. npx -y xno-skills@4.5.
|
|
95
|
+
1. bunx -y xno-skills@4.5.2 <command>
|
|
96
|
+
2. pnpm dlx xno-skills@4.5.2 <command>
|
|
97
|
+
3. npx -y xno-skills@4.5.2 <command>
|
|
98
98
|
```
|
|
99
99
|
|
|
100
100
|
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.
|
|
101
101
|
|
|
102
102
|
Before guessing a subcommand, run `--help`:
|
|
103
103
|
```bash
|
|
104
|
-
bunx -y xno-skills@4.5.
|
|
104
|
+
bunx -y xno-skills@4.5.2 --help
|
|
105
105
|
```
|
|
106
106
|
|
|
107
107
|
### 3. Wallet lifecycle → `ows` skill only
|
|
@@ -130,7 +130,7 @@ When the user asks for an account, block, transaction, or explorer link, always
|
|
|
130
130
|
- **Proactivity on pending funds**: If you see pending funds during any balance check, call `wallet_receive` immediately. Do not wait for the user to ask.
|
|
131
131
|
- **Persistence on "Account not found"**: This is normal for a brand-new, unopened account. Continue — `wallet_receive` will automatically build an open block (sets `previous` to zeros), sign it via OWS, generate PoW, and broadcast. Never conclude you are unauthorized or that OWS cannot sign Nano blocks.
|
|
132
132
|
- **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
|
|
133
|
-
- **Supply chain**: Only use `xno-skills@4.5.
|
|
133
|
+
- **Supply chain**: Only use `xno-skills@4.5.2` and `@open-wallet-standard/core`. No other npm packages.
|
|
134
134
|
- **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.
|
|
135
135
|
|
|
136
136
|
---
|
|
@@ -161,8 +161,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
|
|
|
161
161
|
|
|
162
162
|
**Via CLI (required flags only):**
|
|
163
163
|
```bash
|
|
164
|
-
bunx -y xno-skills@4.5.
|
|
165
|
-
bunx -y xno-skills@4.5.
|
|
164
|
+
bunx -y xno-skills@4.5.2 balance --wallet "my-wallet"
|
|
165
|
+
bunx -y xno-skills@4.5.2 rpc account-balance <address>
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
|
|
@@ -193,7 +193,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
|
|
|
193
193
|
|
|
194
194
|
**Via CLI (required flags only):**
|
|
195
195
|
```bash
|
|
196
|
-
bunx -y xno-skills@4.5.
|
|
196
|
+
bunx -y xno-skills@4.5.2 receive --wallet "my-wallet"
|
|
197
197
|
```
|
|
198
198
|
|
|
199
199
|
Full options: [receive](references/receive.md)
|
|
@@ -225,7 +225,7 @@ The account must be opened (have a receive block) and have sufficient balance.
|
|
|
225
225
|
|
|
226
226
|
**Via CLI (required flags only):**
|
|
227
227
|
```bash
|
|
228
|
-
bunx -y xno-skills@4.5.
|
|
228
|
+
bunx -y xno-skills@4.5.2 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
|
|
229
229
|
```
|
|
230
230
|
|
|
231
231
|
Full options: [send](references/send.md)
|
|
@@ -341,7 +341,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
|
|
|
341
341
|
|
|
342
342
|
**Via CLI (required args only):**
|
|
343
343
|
```bash
|
|
344
|
-
bunx -y xno-skills@4.5.
|
|
344
|
+
bunx -y xno-skills@4.5.2 qr nano_1abc...
|
|
345
345
|
```
|
|
346
346
|
|
|
347
347
|
Full options: [qr](references/qr.md)
|
|
@@ -368,7 +368,7 @@ All validation is **offline** — no network required.
|
|
|
368
368
|
|
|
369
369
|
**Via CLI:**
|
|
370
370
|
```bash
|
|
371
|
-
bunx -y xno-skills@4.5.
|
|
371
|
+
bunx -y xno-skills@4.5.2 validate nano_1abc...
|
|
372
372
|
```
|
|
373
373
|
|
|
374
374
|
Full options: [validate](references/validate.md)
|
|
@@ -395,10 +395,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
|
|
|
395
395
|
|
|
396
396
|
**Via CLI:**
|
|
397
397
|
```bash
|
|
398
|
-
bunx -y xno-skills@4.5.
|
|
399
|
-
bunx -y xno-skills@4.5.
|
|
400
|
-
bunx -y xno-skills@4.5.
|
|
401
|
-
bunx -y xno-skills@4.5.
|
|
398
|
+
bunx -y xno-skills@4.5.2 convert 1 xno # all units
|
|
399
|
+
bunx -y xno-skills@4.5.2 convert 1 knano
|
|
400
|
+
bunx -y xno-skills@4.5.2 convert 1000000000000000000000000000000 raw
|
|
401
|
+
bunx -y xno-skills@4.5.2 convert 1 xno --json
|
|
402
402
|
```
|
|
403
403
|
|
|
404
404
|
Full options: [convert](references/convert.md)
|
|
@@ -424,20 +424,20 @@ Present the user with this command to run locally:
|
|
|
424
424
|
|
|
425
425
|
```bash
|
|
426
426
|
# Sign — run this yourself, replacing the placeholder with your actual key
|
|
427
|
-
bunx -y xno-skills@4.5.
|
|
427
|
+
bunx -y xno-skills@4.5.2 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
|
|
428
428
|
|
|
429
429
|
# Sign with JSON output
|
|
430
|
-
bunx -y xno-skills@4.5.
|
|
430
|
+
bunx -y xno-skills@4.5.2 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
|
|
431
431
|
```
|
|
432
432
|
|
|
433
433
|
For verify, the agent *can* run this directly (no secret material involved):
|
|
434
434
|
|
|
435
435
|
```bash
|
|
436
436
|
# Verify
|
|
437
|
-
bunx -y xno-skills@4.5.
|
|
437
|
+
bunx -y xno-skills@4.5.2 verify <nano_address> "<message>" <signature-hex>
|
|
438
438
|
|
|
439
439
|
# Verify with JSON output
|
|
440
|
-
bunx -y xno-skills@4.5.
|
|
440
|
+
bunx -y xno-skills@4.5.2 verify <nano_address> "<message>" <signature-hex> --json
|
|
441
441
|
```
|
|
442
442
|
|
|
443
443
|
**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.
|
|
@@ -512,7 +512,7 @@ PoW input:
|
|
|
512
512
|
{ "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
|
|
513
513
|
```
|
|
514
514
|
```bash
|
|
515
|
-
bunx -y xno-skills@4.5.
|
|
515
|
+
bunx -y xno-skills@4.5.2 change-rep --wallet "my-wallet" --representative "nano_..."
|
|
516
516
|
```
|
|
517
517
|
|
|
518
518
|
Full options: [change-rep](references/change-rep.md)
|