xno-skills 4.6.1 → 4.7.1
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 +5 -5
- package/dist/cjs/cli.js +4 -4
- 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/cli.js +4 -4
- 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 +28 -26
- package/skills/nano/references/mcp.md +4 -4
package/README.md
CHANGED
|
@@ -72,7 +72,7 @@ xno-skills --help
|
|
|
72
72
|
|
|
73
73
|
To pin to the current stable release instead:
|
|
74
74
|
```bash
|
|
75
|
-
npm install -g xno-skills@4.
|
|
75
|
+
npm install -g xno-skills@4.7.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
|
|
@@ -132,7 +132,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
|
|
|
132
132
|
**Preferred** (global install — avoids `npx` concurrency handshake failures):
|
|
133
133
|
|
|
134
134
|
```bash
|
|
135
|
-
npm install -g xno-skills@4.
|
|
135
|
+
npm install -g xno-skills@4.7.1
|
|
136
136
|
```
|
|
137
137
|
|
|
138
138
|
```json
|
|
@@ -153,7 +153,7 @@ npm install -g xno-skills@4.6.1
|
|
|
153
153
|
"mcpServers": {
|
|
154
154
|
"nano": {
|
|
155
155
|
"command": "npx",
|
|
156
|
-
"args": ["-y", "-p", "xno-skills@4.
|
|
156
|
+
"args": ["-y", "-p", "xno-skills@4.7.1", "xno-mcp"]
|
|
157
157
|
}
|
|
158
158
|
}
|
|
159
159
|
}
|
|
@@ -166,7 +166,7 @@ npm install -g xno-skills@4.6.1
|
|
|
166
166
|
<summary>Codex</summary>
|
|
167
167
|
|
|
168
168
|
```bash
|
|
169
|
-
# Preferred (after npm install -g xno-skills@4.
|
|
169
|
+
# Preferred (after npm install -g xno-skills@4.7.1):
|
|
170
170
|
codex mcp add nano \
|
|
171
171
|
-c sandbox_mode="danger-full-access" \
|
|
172
172
|
-c 'sandbox_permissions=["network-access"]' \
|
|
@@ -176,7 +176,7 @@ codex mcp add nano \
|
|
|
176
176
|
codex mcp add nano \
|
|
177
177
|
-c sandbox_mode="danger-full-access" \
|
|
178
178
|
-c 'sandbox_permissions=["network-access"]' \
|
|
179
|
-
-- npx -y -p xno-skills@4.
|
|
179
|
+
-- npx -y -p xno-skills@4.7.1 xno-mcp
|
|
180
180
|
```
|
|
181
181
|
</details>
|
|
182
182
|
|
package/dist/cjs/cli.js
CHANGED
|
@@ -797,7 +797,7 @@ Configuration for popular AI agent harnesses:
|
|
|
797
797
|
|
|
798
798
|
Preferred (global install — avoids npx concurrency handshake failures):
|
|
799
799
|
|
|
800
|
-
npm install -g xno-skills@4.
|
|
800
|
+
npm install -g xno-skills@4.7.1
|
|
801
801
|
|
|
802
802
|
1. Claude Desktop / Cursor / Roo Code (in config.json):
|
|
803
803
|
{
|
|
@@ -822,16 +822,16 @@ Fallback (if global install is not possible):
|
|
|
822
822
|
"mcpServers": {
|
|
823
823
|
"xno": {
|
|
824
824
|
"command": "npx",
|
|
825
|
-
"args": ["-y", "xno-skills@4.
|
|
825
|
+
"args": ["-y", "xno-skills@4.7.1", "mcp"]
|
|
826
826
|
}
|
|
827
827
|
}
|
|
828
828
|
}
|
|
829
829
|
|
|
830
830
|
2. Gemini CLI:
|
|
831
|
-
gemini mcp add xno npx -y xno-skills@4.
|
|
831
|
+
gemini mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
832
832
|
|
|
833
833
|
3. Claude Code:
|
|
834
|
-
claude mcp add xno npx -y xno-skills@4.
|
|
834
|
+
claude mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
835
835
|
|
|
836
836
|
To run the MCP server directly in this terminal:
|
|
837
837
|
xno-skills mcp (if globally installed)
|
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": "mt1688788ukuih",
|
|
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-08-
|
|
12
|
-
"updatedAt": "2026-08-
|
|
11
|
+
"createdAt": "2026-08-20T07:00:25.604Z",
|
|
12
|
+
"updatedAt": "2026-08-20T07:00:25.604Z",
|
|
13
13
|
"receivedBlocks": []
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
|
-
"id": "
|
|
16
|
+
"id": "mt16887wzsuywg",
|
|
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-08-
|
|
24
|
-
"updatedAt": "2026-08-
|
|
23
|
+
"createdAt": "2026-08-20T07:00:25.628Z",
|
|
24
|
+
"updatedAt": "2026-08-20T07:00:25.628Z",
|
|
25
25
|
"receivedBlocks": []
|
|
26
26
|
}
|
|
27
27
|
]
|
package/dist/esm/cli.js
CHANGED
|
@@ -797,7 +797,7 @@ Configuration for popular AI agent harnesses:
|
|
|
797
797
|
|
|
798
798
|
Preferred (global install — avoids npx concurrency handshake failures):
|
|
799
799
|
|
|
800
|
-
npm install -g xno-skills@4.
|
|
800
|
+
npm install -g xno-skills@4.7.1
|
|
801
801
|
|
|
802
802
|
1. Claude Desktop / Cursor / Roo Code (in config.json):
|
|
803
803
|
{
|
|
@@ -822,16 +822,16 @@ Fallback (if global install is not possible):
|
|
|
822
822
|
"mcpServers": {
|
|
823
823
|
"xno": {
|
|
824
824
|
"command": "npx",
|
|
825
|
-
"args": ["-y", "xno-skills@4.
|
|
825
|
+
"args": ["-y", "xno-skills@4.7.1", "mcp"]
|
|
826
826
|
}
|
|
827
827
|
}
|
|
828
828
|
}
|
|
829
829
|
|
|
830
830
|
2. Gemini CLI:
|
|
831
|
-
gemini mcp add xno npx -y xno-skills@4.
|
|
831
|
+
gemini mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
832
832
|
|
|
833
833
|
3. Claude Code:
|
|
834
|
-
claude mcp add xno npx -y xno-skills@4.
|
|
834
|
+
claude mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
835
835
|
|
|
836
836
|
To run the MCP server directly in this terminal:
|
|
837
837
|
xno-skills mcp (if globally installed)
|
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.
|
|
3
|
+
"version": "4.7.1",
|
|
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",
|
|
@@ -82,7 +82,7 @@
|
|
|
82
82
|
"@noble/curves": "^2.0.1",
|
|
83
83
|
"@noble/hashes": "^1.7.0",
|
|
84
84
|
"@open-wallet-standard/core": "^1.3.2",
|
|
85
|
-
"@openrai/nano-core": "^3.
|
|
85
|
+
"@openrai/nano-core": "^3.3.0",
|
|
86
86
|
"commander": "^14.0.3",
|
|
87
87
|
"qrcode-svg": "^1.1.0",
|
|
88
88
|
"qrcode-terminal": "^0.12.0",
|
package/skills/nano/SKILL.md
CHANGED
|
@@ -85,12 +85,12 @@ If the client supports MCP, set it up as a "stdio" type MCP server.
|
|
|
85
85
|
|
|
86
86
|
**Preferred — global install** (avoids `npx` concurrency issues that cause handshake failures):
|
|
87
87
|
|
|
88
|
-
npm install -g xno-skills@4.
|
|
88
|
+
npm install -g xno-skills@4.7.1
|
|
89
89
|
xno-skills mcp
|
|
90
90
|
|
|
91
91
|
**Fallback** (only if global install is not possible):
|
|
92
92
|
|
|
93
|
-
npx -y xno-skills@4.
|
|
93
|
+
npx -y xno-skills@4.7.1 mcp
|
|
94
94
|
|
|
95
95
|
> **Why not `npx` by default?** When multiple agent sessions start concurrently, `npx` can fail during package resolution — the second process exits before the MCP handshake completes. A global install eliminates this race.
|
|
96
96
|
|
|
@@ -102,16 +102,16 @@ If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage,
|
|
|
102
102
|
|
|
103
103
|
```
|
|
104
104
|
1. xno-skills <command> (global install — preferred)
|
|
105
|
-
2. bunx -y xno-skills@4.
|
|
106
|
-
3. pnpm dlx xno-skills@4.
|
|
107
|
-
4. npx -y xno-skills@4.
|
|
105
|
+
2. bunx -y xno-skills@4.7.1 <command>
|
|
106
|
+
3. pnpm dlx xno-skills@4.7.1 <command>
|
|
107
|
+
4. npx -y xno-skills@4.7.1 <command>
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`@4.5.2`) with `bunx`/`pnpm dlx`/`npx` to prevent interactive prompts from freezing.
|
|
111
111
|
|
|
112
112
|
Before guessing a subcommand, run `--help`:
|
|
113
113
|
```bash
|
|
114
|
-
xno-skills --help # or: bunx -y xno-skills@4.
|
|
114
|
+
xno-skills --help # or: bunx -y xno-skills@4.7.1 --help
|
|
115
115
|
```
|
|
116
116
|
|
|
117
117
|
### 3. Wallet lifecycle → `ows` skill only
|
|
@@ -137,10 +137,10 @@ When the user asks for an account, block, transaction, or explorer link, always
|
|
|
137
137
|
|
|
138
138
|
- **State verification**: Always fetch balance and frontier via RPC before manually building a block. Never hallucinate previous hashes.
|
|
139
139
|
- **PoW is automatic**: MCP tools and the CLI both handle PoW internally. Never attempt to supply or generate PoW manually.
|
|
140
|
-
- **
|
|
140
|
+
- **Pre-send state**: Before `wallet_send`, inspect the source wallet's confirmed balance and total receivable amount with `wallet_balance`. If confirmed funds cannot cover the requested send and receivables are needed, call `wallet_receive`, then recheck. Do not submit receive blocks merely because unrelated funds are pending.
|
|
141
141
|
- **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.
|
|
142
142
|
- **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
|
|
143
|
-
- **Supply chain**: Only use `xno-skills@4.
|
|
143
|
+
- **Supply chain**: Only use `xno-skills@4.7.1` and `@open-wallet-standard/core`. No other npm packages.
|
|
144
144
|
- **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.
|
|
145
145
|
|
|
146
146
|
---
|
|
@@ -171,8 +171,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
|
|
|
171
171
|
|
|
172
172
|
**Via CLI (required flags only):**
|
|
173
173
|
```bash
|
|
174
|
-
bunx -y xno-skills@4.
|
|
175
|
-
bunx -y xno-skills@4.
|
|
174
|
+
bunx -y xno-skills@4.7.1 balance --wallet "my-wallet"
|
|
175
|
+
bunx -y xno-skills@4.7.1 rpc account-balance <address>
|
|
176
176
|
```
|
|
177
177
|
|
|
178
178
|
Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
|
|
@@ -182,7 +182,7 @@ Full options: [balance](references/balance.md), [rpc_account-balance](references
|
|
|
182
182
|
- `https://nanoslo.0x.no/proxy` (secondary)
|
|
183
183
|
- `https://rpc.nano.to` (tertiary)
|
|
184
184
|
|
|
185
|
-
|
|
185
|
+
Pending funds are not spendable. Receive them only when the user asks to claim them or they are needed for the requested operation (see Receiving Funds section).
|
|
186
186
|
|
|
187
187
|
---
|
|
188
188
|
|
|
@@ -194,7 +194,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
|
|
|
194
194
|
|
|
195
195
|
> **OWS DOES support Nano block signing.** Never assume otherwise.
|
|
196
196
|
|
|
197
|
-
|
|
197
|
+
When receipt is requested or needed to fund a send, call `wallet_receive`. Do not treat an unopened account as a blocker: `wallet_receive` handles the open block.
|
|
198
198
|
|
|
199
199
|
**Via MCP:**
|
|
200
200
|
```json
|
|
@@ -203,7 +203,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
|
|
|
203
203
|
|
|
204
204
|
**Via CLI (required flags only):**
|
|
205
205
|
```bash
|
|
206
|
-
bunx -y xno-skills@4.
|
|
206
|
+
bunx -y xno-skills@4.7.1 receive --wallet "my-wallet"
|
|
207
207
|
```
|
|
208
208
|
|
|
209
209
|
Full options: [receive](references/receive.md)
|
|
@@ -228,6 +228,8 @@ If no `defaultRepresentative` is configured via `config_set`, pass `representati
|
|
|
228
228
|
|
|
229
229
|
The account must be opened (have a receive block) and have sufficient balance.
|
|
230
230
|
|
|
231
|
+
**Preflight**: Call `wallet_balance` for the source wallet before each send. If its confirmed balance is insufficient but its receivable amount can cover the requested send, call `wallet_receive` and recheck before sending. Do not receive unrelated pending funds solely because they exist.
|
|
232
|
+
|
|
231
233
|
**Via MCP:**
|
|
232
234
|
```json
|
|
233
235
|
{ "name": "wallet_send", "arguments": { "wallet": "my-wallet", "destination": "nano_...", "amountXno": "0.01" } }
|
|
@@ -235,7 +237,7 @@ The account must be opened (have a receive block) and have sufficient balance.
|
|
|
235
237
|
|
|
236
238
|
**Via CLI (required flags only):**
|
|
237
239
|
```bash
|
|
238
|
-
bunx -y xno-skills@4.
|
|
240
|
+
bunx -y xno-skills@4.7.1 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
|
|
239
241
|
```
|
|
240
242
|
|
|
241
243
|
Full options: [send](references/send.md)
|
|
@@ -351,7 +353,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
|
|
|
351
353
|
|
|
352
354
|
**Via CLI (required args only):**
|
|
353
355
|
```bash
|
|
354
|
-
bunx -y xno-skills@4.
|
|
356
|
+
bunx -y xno-skills@4.7.1 qr nano_1abc...
|
|
355
357
|
```
|
|
356
358
|
|
|
357
359
|
Full options: [qr](references/qr.md)
|
|
@@ -378,7 +380,7 @@ All validation is **offline** — no network required.
|
|
|
378
380
|
|
|
379
381
|
**Via CLI:**
|
|
380
382
|
```bash
|
|
381
|
-
bunx -y xno-skills@4.
|
|
383
|
+
bunx -y xno-skills@4.7.1 validate nano_1abc...
|
|
382
384
|
```
|
|
383
385
|
|
|
384
386
|
Full options: [validate](references/validate.md)
|
|
@@ -405,10 +407,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
|
|
|
405
407
|
|
|
406
408
|
**Via CLI:**
|
|
407
409
|
```bash
|
|
408
|
-
bunx -y xno-skills@4.
|
|
409
|
-
bunx -y xno-skills@4.
|
|
410
|
-
bunx -y xno-skills@4.
|
|
411
|
-
bunx -y xno-skills@4.
|
|
410
|
+
bunx -y xno-skills@4.7.1 convert 1 xno # all units
|
|
411
|
+
bunx -y xno-skills@4.7.1 convert 1 knano
|
|
412
|
+
bunx -y xno-skills@4.7.1 convert 1000000000000000000000000000000 raw
|
|
413
|
+
bunx -y xno-skills@4.7.1 convert 1 xno --json
|
|
412
414
|
```
|
|
413
415
|
|
|
414
416
|
Full options: [convert](references/convert.md)
|
|
@@ -434,20 +436,20 @@ Present the user with this command to run locally:
|
|
|
434
436
|
|
|
435
437
|
```bash
|
|
436
438
|
# Sign — run this yourself, replacing the placeholder with your actual key
|
|
437
|
-
bunx -y xno-skills@4.
|
|
439
|
+
bunx -y xno-skills@4.7.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
|
|
438
440
|
|
|
439
441
|
# Sign with JSON output
|
|
440
|
-
bunx -y xno-skills@4.
|
|
442
|
+
bunx -y xno-skills@4.7.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
|
|
441
443
|
```
|
|
442
444
|
|
|
443
445
|
For verify, the agent *can* run this directly (no secret material involved):
|
|
444
446
|
|
|
445
447
|
```bash
|
|
446
448
|
# Verify
|
|
447
|
-
bunx -y xno-skills@4.
|
|
449
|
+
bunx -y xno-skills@4.7.1 verify <nano_address> "<message>" <signature-hex>
|
|
448
450
|
|
|
449
451
|
# Verify with JSON output
|
|
450
|
-
bunx -y xno-skills@4.
|
|
452
|
+
bunx -y xno-skills@4.7.1 verify <nano_address> "<message>" <signature-hex> --json
|
|
451
453
|
```
|
|
452
454
|
|
|
453
455
|
**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.
|
|
@@ -526,7 +528,7 @@ PoW input:
|
|
|
526
528
|
{ "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
|
|
527
529
|
```
|
|
528
530
|
```bash
|
|
529
|
-
bunx -y xno-skills@4.
|
|
531
|
+
bunx -y xno-skills@4.7.1 change-rep --wallet "my-wallet" --representative "nano_..."
|
|
530
532
|
```
|
|
531
533
|
|
|
532
534
|
Full options: [change-rep](references/change-rep.md)
|
|
@@ -697,6 +699,6 @@ On first use, the system probes local backends to build a local-first execution
|
|
|
697
699
|
```
|
|
698
700
|
1. wallet_list: {} → discover "my-wallet" exists
|
|
699
701
|
2. wallet_balance: { wallet: "my-wallet" } → check balance / pending
|
|
700
|
-
3. wallet_receive: { wallet: "my-wallet" } →
|
|
702
|
+
3. wallet_receive: { wallet: "my-wallet" } → only if receipt was requested or pending funds are needed
|
|
701
703
|
4. wallet_send: { wallet: "my-wallet", destination: "nano_...", amountXno: "0.01" }
|
|
702
704
|
```
|
|
@@ -12,7 +12,7 @@ Configuration for popular AI agent harnesses:
|
|
|
12
12
|
|
|
13
13
|
Preferred (global install — avoids npx concurrency handshake failures):
|
|
14
14
|
|
|
15
|
-
npm install -g xno-skills@4.
|
|
15
|
+
npm install -g xno-skills@4.7.1
|
|
16
16
|
|
|
17
17
|
1. Claude Desktop / Cursor / Roo Code (in config.json):
|
|
18
18
|
{
|
|
@@ -37,16 +37,16 @@ Fallback (if global install is not possible):
|
|
|
37
37
|
"mcpServers": {
|
|
38
38
|
"xno": {
|
|
39
39
|
"command": "npx",
|
|
40
|
-
"args": ["-y", "xno-skills@4.
|
|
40
|
+
"args": ["-y", "xno-skills@4.7.1", "mcp"]
|
|
41
41
|
}
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
44
|
|
|
45
45
|
2. Gemini CLI:
|
|
46
|
-
gemini mcp add xno npx -y xno-skills@4.
|
|
46
|
+
gemini mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
47
47
|
|
|
48
48
|
3. Claude Code:
|
|
49
|
-
claude mcp add xno npx -y xno-skills@4.
|
|
49
|
+
claude mcp add xno npx -y xno-skills@4.7.1 mcp
|
|
50
50
|
|
|
51
51
|
To run the MCP server directly in this terminal:
|
|
52
52
|
xno-skills mcp (if globally installed)
|