xno-skills 5.1.0 → 5.1.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 +7 -6
- 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/cli.js +4 -4
- 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 +24 -24
- package/skills/nano/references/mcp.md +4 -4
package/README.md
CHANGED
|
@@ -32,7 +32,6 @@ PoW runs locally through the `nano-core` work provider when recommended. Otherwi
|
|
|
32
32
|
|
|
33
33
|
## Agent Skills
|
|
34
34
|
|
|
35
|
-
[](https://smithery.ai/servers/casualsecurityinc/xno-skills)
|
|
36
35
|
[](https://skills.sh/casualsecurityinc/xno-skills)
|
|
37
36
|
|
|
38
37
|
Built-in skill for Personal AI Agents (OpenClaw etc.) and humans with AI Coding Assistants (Claude Code, Cursor, etc.) alike:
|
|
@@ -77,7 +76,7 @@ xno-skills --help
|
|
|
77
76
|
To pin to the current stable release instead:
|
|
78
77
|
|
|
79
78
|
```bash
|
|
80
|
-
npm install -g xno-skills@5.1.
|
|
79
|
+
npm install -g xno-skills@5.1.1 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
|
|
81
80
|
```
|
|
82
81
|
|
|
83
82
|
### Wallet Operations
|
|
@@ -134,12 +133,14 @@ Wallet lifecycle (create, import, rename, delete) is managed by [OWS](https://gi
|
|
|
134
133
|
|
|
135
134
|
## MCP Server
|
|
136
135
|
|
|
136
|
+
The Nano wallet MCP server runs on your machine over stdio and uses your local OWS wallet. There is no hosted endpoint. Use the npm setup below and see [skill installation](#agent-skills) for the GitHub install command.
|
|
137
|
+
|
|
137
138
|
Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Codex, etc.). MCP resources (`xno-wallet://` URIs) are served but require client-side `resources/read` support — not yet available in OpenCode ([#15535](https://github.com/anomalyco/opencode/issues/15535)).
|
|
138
139
|
|
|
139
140
|
**Preferred** (global install — avoids `npx` concurrency handshake failures):
|
|
140
141
|
|
|
141
142
|
```bash
|
|
142
|
-
npm install -g xno-skills@5.1.
|
|
143
|
+
npm install -g xno-skills@5.1.1
|
|
143
144
|
```
|
|
144
145
|
|
|
145
146
|
```json
|
|
@@ -160,7 +161,7 @@ npm install -g xno-skills@5.1.0
|
|
|
160
161
|
"mcpServers": {
|
|
161
162
|
"nano": {
|
|
162
163
|
"command": "npx",
|
|
163
|
-
"args": ["-y", "-p", "xno-skills@5.1.
|
|
164
|
+
"args": ["-y", "-p", "xno-skills@5.1.1", "xno-mcp"]
|
|
164
165
|
}
|
|
165
166
|
}
|
|
166
167
|
}
|
|
@@ -172,7 +173,7 @@ npm install -g xno-skills@5.1.0
|
|
|
172
173
|
<summary>Codex</summary>
|
|
173
174
|
|
|
174
175
|
```bash
|
|
175
|
-
# Preferred (after npm install -g xno-skills@5.1.
|
|
176
|
+
# Preferred (after npm install -g xno-skills@5.1.1):
|
|
176
177
|
codex mcp add nano \
|
|
177
178
|
-c sandbox_mode="danger-full-access" \
|
|
178
179
|
-c 'sandbox_permissions=["network-access"]' \
|
|
@@ -182,7 +183,7 @@ codex mcp add nano \
|
|
|
182
183
|
codex mcp add nano \
|
|
183
184
|
-c sandbox_mode="danger-full-access" \
|
|
184
185
|
-c 'sandbox_permissions=["network-access"]' \
|
|
185
|
-
-- npx -y -p xno-skills@5.1.
|
|
186
|
+
-- npx -y -p xno-skills@5.1.1 xno-mcp
|
|
186
187
|
```
|
|
187
188
|
|
|
188
189
|
</details>
|
package/dist/cjs/cli.js
CHANGED
|
@@ -757,7 +757,7 @@ Configuration for popular AI agent harnesses:
|
|
|
757
757
|
|
|
758
758
|
Preferred (global install — avoids npx concurrency handshake failures):
|
|
759
759
|
|
|
760
|
-
npm install -g xno-skills@5.1.
|
|
760
|
+
npm install -g xno-skills@5.1.1
|
|
761
761
|
|
|
762
762
|
1. Claude Desktop / Cursor / Roo Code (in config.json):
|
|
763
763
|
{
|
|
@@ -782,16 +782,16 @@ Fallback (if global install is not possible):
|
|
|
782
782
|
"mcpServers": {
|
|
783
783
|
"xno": {
|
|
784
784
|
"command": "npx",
|
|
785
|
-
"args": ["-y", "xno-skills@5.1.
|
|
785
|
+
"args": ["-y", "xno-skills@5.1.1", "mcp"]
|
|
786
786
|
}
|
|
787
787
|
}
|
|
788
788
|
}
|
|
789
789
|
|
|
790
790
|
2. Gemini CLI:
|
|
791
|
-
gemini mcp add xno npx -y xno-skills@5.1.
|
|
791
|
+
gemini mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
792
792
|
|
|
793
793
|
3. Claude Code:
|
|
794
|
-
claude mcp add xno npx -y xno-skills@5.1.
|
|
794
|
+
claude mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
795
795
|
|
|
796
796
|
To run the MCP server directly in this terminal:
|
|
797
797
|
xno-skills mcp (if globally installed)
|
package/dist/cjs/version.d.ts
CHANGED
package/dist/cjs/version.js
CHANGED
package/dist/esm/cli.js
CHANGED
|
@@ -757,7 +757,7 @@ Configuration for popular AI agent harnesses:
|
|
|
757
757
|
|
|
758
758
|
Preferred (global install — avoids npx concurrency handshake failures):
|
|
759
759
|
|
|
760
|
-
npm install -g xno-skills@5.1.
|
|
760
|
+
npm install -g xno-skills@5.1.1
|
|
761
761
|
|
|
762
762
|
1. Claude Desktop / Cursor / Roo Code (in config.json):
|
|
763
763
|
{
|
|
@@ -782,16 +782,16 @@ Fallback (if global install is not possible):
|
|
|
782
782
|
"mcpServers": {
|
|
783
783
|
"xno": {
|
|
784
784
|
"command": "npx",
|
|
785
|
-
"args": ["-y", "xno-skills@5.1.
|
|
785
|
+
"args": ["-y", "xno-skills@5.1.1", "mcp"]
|
|
786
786
|
}
|
|
787
787
|
}
|
|
788
788
|
}
|
|
789
789
|
|
|
790
790
|
2. Gemini CLI:
|
|
791
|
-
gemini mcp add xno npx -y xno-skills@5.1.
|
|
791
|
+
gemini mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
792
792
|
|
|
793
793
|
3. Claude Code:
|
|
794
|
-
claude mcp add xno npx -y xno-skills@5.1.
|
|
794
|
+
claude mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
795
795
|
|
|
796
796
|
To run the MCP server directly in this terminal:
|
|
797
797
|
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": "5.1.
|
|
3
|
+
"version": "5.1.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",
|
package/skills/nano/SKILL.md
CHANGED
|
@@ -106,12 +106,12 @@ If the client supports MCP, set it up as a "stdio" type MCP server.
|
|
|
106
106
|
|
|
107
107
|
**Preferred — global install** (avoids `npx` concurrency issues that cause handshake failures):
|
|
108
108
|
|
|
109
|
-
npm install -g xno-skills@5.1.
|
|
109
|
+
npm install -g xno-skills@5.1.1
|
|
110
110
|
xno-skills mcp
|
|
111
111
|
|
|
112
112
|
**Fallback** (only if global install is not possible):
|
|
113
113
|
|
|
114
|
-
npx -y xno-skills@5.1.
|
|
114
|
+
npx -y xno-skills@5.1.1 mcp
|
|
115
115
|
|
|
116
116
|
> **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.
|
|
117
117
|
|
|
@@ -123,22 +123,22 @@ If `xno-mcp` tools are not available, or the user explicitly asks for CLI usage,
|
|
|
123
123
|
|
|
124
124
|
```
|
|
125
125
|
1. xno-skills <command> (global install — preferred)
|
|
126
|
-
2. bunx -y xno-skills@5.1.
|
|
127
|
-
3. pnpm dlx xno-skills@5.1.
|
|
128
|
-
4. npx -y xno-skills@5.1.
|
|
126
|
+
2. bunx -y xno-skills@5.1.1 <command>
|
|
127
|
+
3. pnpm dlx xno-skills@5.1.1 <command>
|
|
128
|
+
4. npx -y xno-skills@5.1.1 <command>
|
|
129
129
|
```
|
|
130
130
|
|
|
131
|
-
If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`xno-skills@5.1.
|
|
131
|
+
If the global `xno-skills` binary is not available, fall through to the next option. Always pin the version (`xno-skills@5.1.1`) with `bunx`/`pnpm dlx`/`npx` to prevent interactive prompts from freezing.
|
|
132
132
|
|
|
133
133
|
Before guessing a subcommand, run `--help`:
|
|
134
134
|
|
|
135
135
|
```bash
|
|
136
|
-
xno-skills --help # or: bunx -y xno-skills@5.1.
|
|
136
|
+
xno-skills --help # or: bunx -y xno-skills@5.1.1 --help
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
### 3. Wallet creation and lifecycle
|
|
140
140
|
|
|
141
|
-
Create a wallet only on explicit user request. Ask for a name if missing. Call `wallet_create` with `{"name":"treasury"}` or run `xno-skills wallet create --name treasury` when using the CLI. The installed `@open-wallet-standard/core` npm dependency writes to the local OWS vault and the command returns only `name` and the Nano `address`. Creation uses the installed runtime without downloading dependencies or requiring a global `ows` command. If the runtime is missing, show the pinned npm install command and wait for the user to run it. [Wallet creation source](https://github.com/CasualSecurityInc/xno-skills/blob/v5.1.
|
|
141
|
+
Create a wallet only on explicit user request. Ask for a name if missing. Call `wallet_create` with `{"name":"treasury"}` or run `xno-skills wallet create --name treasury` when using the CLI. The installed `@open-wallet-standard/core` npm dependency writes to the local OWS vault and the command returns only `name` and the Nano `address`. Creation uses the installed runtime without downloading dependencies or requiring a global `ows` command. If the runtime is missing, show the pinned npm install command and wait for the user to run it. [Wallet creation source](https://github.com/CasualSecurityInc/xno-skills/blob/v5.1.1/src/nano-actions.ts)
|
|
142
142
|
|
|
143
143
|
For wallet **import, rename, or delete**: delegate to the `ows` skill.
|
|
144
144
|
|
|
@@ -164,7 +164,7 @@ When the user asks for an account, block, transaction, or explorer link, always
|
|
|
164
164
|
- **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.
|
|
165
165
|
- **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.
|
|
166
166
|
- **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
|
|
167
|
-
- **Supply chain**: Only use `xno-skills@5.1.
|
|
167
|
+
- **Supply chain**: Only use `xno-skills@5.1.1` and `@open-wallet-standard/core`. No other npm packages.
|
|
168
168
|
- **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.
|
|
169
169
|
|
|
170
170
|
---
|
|
@@ -198,8 +198,8 @@ To **create** a new wallet on request, use `wallet_create` as described above.
|
|
|
198
198
|
**Via CLI (required flags only):**
|
|
199
199
|
|
|
200
200
|
```bash
|
|
201
|
-
bunx -y xno-skills@5.1.
|
|
202
|
-
bunx -y xno-skills@5.1.
|
|
201
|
+
bunx -y xno-skills@5.1.1 balance --wallet "my-wallet"
|
|
202
|
+
bunx -y xno-skills@5.1.1 rpc account-balance <address>
|
|
203
203
|
```
|
|
204
204
|
|
|
205
205
|
Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
|
|
@@ -233,7 +233,7 @@ When receipt is requested or needed to fund a send, call `wallet_receive`. Do no
|
|
|
233
233
|
**Via CLI (required flags only):**
|
|
234
234
|
|
|
235
235
|
```bash
|
|
236
|
-
bunx -y xno-skills@5.1.
|
|
236
|
+
bunx -y xno-skills@5.1.1 receive --wallet "my-wallet"
|
|
237
237
|
```
|
|
238
238
|
|
|
239
239
|
Full options: [receive](references/receive.md)
|
|
@@ -269,7 +269,7 @@ The account must be opened (have a receive block) and have sufficient balance.
|
|
|
269
269
|
**Via CLI (required flags only):**
|
|
270
270
|
|
|
271
271
|
```bash
|
|
272
|
-
bunx -y xno-skills@5.1.
|
|
272
|
+
bunx -y xno-skills@5.1.1 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
|
|
273
273
|
```
|
|
274
274
|
|
|
275
275
|
Full options: [send](references/send.md)
|
|
@@ -401,7 +401,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
|
|
|
401
401
|
**Via CLI (required args only):**
|
|
402
402
|
|
|
403
403
|
```bash
|
|
404
|
-
bunx -y xno-skills@5.1.
|
|
404
|
+
bunx -y xno-skills@5.1.1 qr nano_1abc...
|
|
405
405
|
```
|
|
406
406
|
|
|
407
407
|
Full options: [qr](references/qr.md)
|
|
@@ -432,7 +432,7 @@ All validation is **offline** — no network required.
|
|
|
432
432
|
**Via CLI:**
|
|
433
433
|
|
|
434
434
|
```bash
|
|
435
|
-
bunx -y xno-skills@5.1.
|
|
435
|
+
bunx -y xno-skills@5.1.1 validate nano_1abc...
|
|
436
436
|
```
|
|
437
437
|
|
|
438
438
|
Full options: [validate](references/validate.md)
|
|
@@ -461,10 +461,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
|
|
|
461
461
|
**Via CLI:**
|
|
462
462
|
|
|
463
463
|
```bash
|
|
464
|
-
bunx -y xno-skills@5.1.
|
|
465
|
-
bunx -y xno-skills@5.1.
|
|
466
|
-
bunx -y xno-skills@5.1.
|
|
467
|
-
bunx -y xno-skills@5.1.
|
|
464
|
+
bunx -y xno-skills@5.1.1 convert 1 xno # all units
|
|
465
|
+
bunx -y xno-skills@5.1.1 convert 1 knano
|
|
466
|
+
bunx -y xno-skills@5.1.1 convert 1000000000000000000000000000000 raw
|
|
467
|
+
bunx -y xno-skills@5.1.1 convert 1 xno --json
|
|
468
468
|
```
|
|
469
469
|
|
|
470
470
|
Full options: [convert](references/convert.md)
|
|
@@ -490,20 +490,20 @@ Present the user with this command to run locally:
|
|
|
490
490
|
|
|
491
491
|
```bash
|
|
492
492
|
# Sign — run this yourself, replacing the placeholder with your actual key
|
|
493
|
-
bunx -y xno-skills@5.1.
|
|
493
|
+
bunx -y xno-skills@5.1.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
|
|
494
494
|
|
|
495
495
|
# Sign with JSON output
|
|
496
|
-
bunx -y xno-skills@5.1.
|
|
496
|
+
bunx -y xno-skills@5.1.1 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
|
|
497
497
|
```
|
|
498
498
|
|
|
499
499
|
For verify, the agent _can_ run this directly (no secret material involved):
|
|
500
500
|
|
|
501
501
|
```bash
|
|
502
502
|
# Verify
|
|
503
|
-
bunx -y xno-skills@5.1.
|
|
503
|
+
bunx -y xno-skills@5.1.1 verify <nano_address> "<message>" <signature-hex>
|
|
504
504
|
|
|
505
505
|
# Verify with JSON output
|
|
506
|
-
bunx -y xno-skills@5.1.
|
|
506
|
+
bunx -y xno-skills@5.1.1 verify <nano_address> "<message>" <signature-hex> --json
|
|
507
507
|
```
|
|
508
508
|
|
|
509
509
|
**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.
|
|
@@ -529,7 +529,7 @@ Deep protocol details — state-block anatomy, open/send/receive/change semantic
|
|
|
529
529
|
```
|
|
530
530
|
|
|
531
531
|
```bash
|
|
532
|
-
bunx -y xno-skills@5.1.
|
|
532
|
+
bunx -y xno-skills@5.1.1 change-rep --wallet "my-wallet" --representative "nano_..."
|
|
533
533
|
```
|
|
534
534
|
|
|
535
535
|
Full options: [change-rep](references/change-rep.md)
|
|
@@ -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@5.1.
|
|
15
|
+
npm install -g xno-skills@5.1.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@5.1.
|
|
40
|
+
"args": ["-y", "xno-skills@5.1.1", "mcp"]
|
|
41
41
|
}
|
|
42
42
|
}
|
|
43
43
|
}
|
|
44
44
|
|
|
45
45
|
2. Gemini CLI:
|
|
46
|
-
gemini mcp add xno npx -y xno-skills@5.1.
|
|
46
|
+
gemini mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
47
47
|
|
|
48
48
|
3. Claude Code:
|
|
49
|
-
claude mcp add xno npx -y xno-skills@5.1.
|
|
49
|
+
claude mcp add xno npx -y xno-skills@5.1.1 mcp
|
|
50
50
|
|
|
51
51
|
To run the MCP server directly in this terminal:
|
|
52
52
|
xno-skills mcp (if globally installed)
|