xno-skills 4.2.3 → 4.3.0

package/README.md

@@ -21,6 +21,13 @@ npx skills add CasualSecurityInc/xno-skills -g
 npx -y skills add CasualSecurityInc/xno-skills -g -y --all
 ```
 
+### Claude Code
+
+```
+/plugin marketplace add CasualSecurityInc/xno-skills
+/plugin install xno-skills@casual-security-inc
+```
+
 > [!IMPORTANT]
 > If you installed skills from this repository before May 4, 2026, you have 11 individual `nano-*` skills that have been consolidated into a single `nano` skill. Remove the old ones first:
 > ```bash
@@ -43,7 +50,7 @@ xno-skills --help
 
 To pin to the current stable release instead:
 ```bash
-npm install -g xno-skills@4.2.3 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
+npm install -g xno-skills@4.3.0 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
 ```
 
 
@@ -102,7 +109,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@4.2.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@4.3.0", "xno-mcp"]
     }
   }
 }
@@ -118,7 +125,7 @@ Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Co
 codex mcp add nano \
   -c sandbox_mode="danger-full-access" \
   -c 'sandbox_permissions=["network-access"]' \
-  -- npx -y -p xno-skills@4.2.3 xno-mcp
+  -- npx -y -p xno-skills@4.3.0 xno-mcp
 ```
 </details>
 
@@ -130,7 +137,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@4.2.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@4.3.0", "xno-mcp"]
     }
   }
 }
@@ -146,7 +153,7 @@ codex mcp add nano \
   "mcp": {
     "nano": {
       "type": "local",
-      "command": ["npx", "-y", "-p", "xno-skills@4.2.3", "xno-mcp"],
+      "command": ["npx", "-y", "-p", "xno-skills@4.3.0", "xno-mcp"],
       "enabled": true
     }
   }
@@ -162,7 +169,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@4.2.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@4.3.0", "xno-mcp"]
     }
   }
 }
@@ -177,7 +184,7 @@ codex mcp add nano \
   "mcpServers": {
     "nano": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@4.2.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@4.3.0", "xno-mcp"]
     }
   }
 }
@@ -193,7 +200,7 @@ codex mcp add nano \
     "nano": {
       "type": "stdio",
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@4.2.3", "xno-mcp"]
+      "args": ["-y", "-p", "xno-skills@4.3.0", "xno-mcp"]
     }
   }
 }

package/dist/cjs/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "4.2.3";
+    readonly version: "4.3.0";
 };
-export declare const version: "4.2.3";
+export declare const version: "4.3.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "4.2.3"
+    version: "4.3.0"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/dist/esm/.xno-mcp/requests.json

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mpp9b32vmd7o9u",
+      "id": "mpwqc34ow8ggcw",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-05-28T08:54:16.663Z",
-      "updatedAt": "2026-05-28T08:54:16.663Z",
+      "createdAt": "2026-06-02T14:25:20.089Z",
+      "updatedAt": "2026-06-02T14:25:20.089Z",
       "receivedBlocks": []
     },
     {
-      "id": "mpp9b33oe3rus8",
+      "id": "mpwqc35bd3kvbn",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_3i1aq1cchnmbn9x5rsbap8b15akfh7wj7pwskuzi7ahz8oq6cobd99d4r3b7",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-05-28T08:54:16.692Z",
-      "updatedAt": "2026-05-28T08:54:16.692Z",
+      "createdAt": "2026-06-02T14:25:20.111Z",
+      "updatedAt": "2026-06-02T14:25:20.111Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "4.2.3";
+    readonly version: "4.3.0";
 };
-export declare const version: "4.2.3";
+export declare const version: "4.3.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/esm/version.js

@@ -2,7 +2,7 @@
 // Keep this in sync by running "npm run build" (prebuild hook).
 export const pkg = {
     name: "xno-skills",
-    version: "4.2.3"
+    version: "4.3.0"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "4.2.3",
+  "version": "4.3.0",
   "description": "The Nano (XNO) toolkit for AI agents and developers. Send, receive, check balances, and manage payment requests without ever handling private keys.",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -24,7 +24,7 @@
   ],
   "scripts": {
     "preversion": "npm test",
-    "version": "node scripts/update-version.js && node scripts/generate-server-card.js && node scripts/generate-cli-refs.js && git add src/version.ts skills/nano/SKILL.md README.md mcpb/server-card.json skills/nano/references/",
+    "version": "node scripts/update-version.js && node scripts/generate-server-card.js && node scripts/generate-cli-refs.js && git add src/version.ts skills/nano/SKILL.md README.md mcpb/server-card.json .claude-plugin/marketplace.json skills/nano/references/",
     "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).');\"",
     "prebuild": "node scripts/update-version.js",
     "prebuild:esm": "node scripts/update-version.js",

package/skills/nano/SKILL.md

@@ -83,7 +83,7 @@ When the environment provides `xno-mcp` tools (`wallet_list`, `wallet_send`, `wa
 
 If the client supports MCP, set it up as a "stdio" type MCP server:
 
-    npx -y -p xno-skills@4.2.3 -- mcp
+    npx -y -p xno-skills@4.3.0 -- mcp
 
 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.
 
@@ -92,16 +92,16 @@ MCP is the primary execution path because tools, schemas, and results are struct
 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:
 
 ```
-1. bunx -y xno-skills@4.2.3 <command>
-2. pnpm dlx xno-skills@4.2.3 <command>
-3. npx -y xno-skills@4.2.3 <command>
+1. bunx -y xno-skills@4.3.0 <command>
+2. pnpm dlx xno-skills@4.3.0 <command>
+3. npx -y xno-skills@4.3.0 <command>
 ```
 
 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.
 
 Before guessing a subcommand, run `--help`:
 ```bash
-bunx -y xno-skills@4.2.3 --help
+bunx -y xno-skills@4.3.0 --help
 ```
 
 ### 3. Wallet lifecycle → `ows` skill only
@@ -130,7 +130,7 @@ When the user asks for an account, block, transaction, or explorer link, always
 - **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.
 - **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.
 - **No mnemonic exports**: Never call `ows wallet export` or suggest exporting to a third-party wallet unless the user explicitly commands it.
-- **Supply chain**: Only use `xno-skills@4.2.3` and `@open-wallet-standard/core`. No other npm packages.
+- **Supply chain**: Only use `xno-skills@4.3.0` and `@open-wallet-standard/core`. No other npm packages.
 - **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.
 
 ---
@@ -161,8 +161,8 @@ To **create** a new wallet, delegate to the `ows` skill. Then return here for al
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@4.2.3 balance --wallet "my-wallet"
-bunx -y xno-skills@4.2.3 rpc account-balance <address>
+bunx -y xno-skills@4.3.0 balance --wallet "my-wallet"
+bunx -y xno-skills@4.3.0 rpc account-balance <address>
 ```
 
 Full options: [balance](references/balance.md), [rpc_account-balance](references/rpc_account-balance.md)
@@ -192,7 +192,7 @@ A Nano transfer shows as **pending** until the recipient publishes a receive blo
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@4.2.3 receive --wallet "my-wallet"
+bunx -y xno-skills@4.3.0 receive --wallet "my-wallet"
 ```
 
 Full options: [receive](references/receive.md)
@@ -224,7 +224,7 @@ The account must be opened (have a receive block) and have sufficient balance.
 
 **Via CLI (required flags only):**
 ```bash
-bunx -y xno-skills@4.2.3 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
+bunx -y xno-skills@4.3.0 send --wallet "my-wallet" --to "nano_..." --amount-xno 0.01
 ```
 
 Full options: [send](references/send.md)
@@ -340,7 +340,7 @@ Generates a terminal-friendly ASCII QR code for a Nano address, optionally with
 
 **Via CLI (required args only):**
 ```bash
-bunx -y xno-skills@4.2.3 qr nano_1abc...
+bunx -y xno-skills@4.3.0 qr nano_1abc...
 ```
 
 Full options: [qr](references/qr.md)
@@ -367,7 +367,7 @@ All validation is **offline** — no network required.
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@4.2.3 validate nano_1abc...
+bunx -y xno-skills@4.3.0 validate nano_1abc...
 ```
 
 Full options: [validate](references/validate.md)
@@ -394,10 +394,10 @@ XNO uses **30 decimal places**. Floating-point arithmetic is unsafe. Always use
 
 **Via CLI:**
 ```bash
-bunx -y xno-skills@4.2.3 convert 1 xno       # all units
-bunx -y xno-skills@4.2.3 convert 1 knano
-bunx -y xno-skills@4.2.3 convert 1000000000000000000000000000000 raw
-bunx -y xno-skills@4.2.3 convert 1 xno --json
+bunx -y xno-skills@4.3.0 convert 1 xno       # all units
+bunx -y xno-skills@4.3.0 convert 1 knano
+bunx -y xno-skills@4.3.0 convert 1000000000000000000000000000000 raw
+bunx -y xno-skills@4.3.0 convert 1 xno --json
 ```
 
 Full options: [convert](references/convert.md)
@@ -423,20 +423,20 @@ Present the user with this command to run locally:
 
 ```bash
 # Sign — run this yourself, replacing the placeholder with your actual key
-bunx -y xno-skills@4.2.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
+bunx -y xno-skills@4.3.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX
 
 # Sign with JSON output
-bunx -y xno-skills@4.2.3 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
+bunx -y xno-skills@4.3.0 sign "<message>" --key YOUR_PRIVATE_KEY_HEX --json
 ```
 
 For verify, the agent *can* run this directly (no secret material involved):
 
 ```bash
 # Verify
-bunx -y xno-skills@4.2.3 verify <nano_address> "<message>" <signature-hex>
+bunx -y xno-skills@4.3.0 verify <nano_address> "<message>" <signature-hex>
 
 # Verify with JSON output
-bunx -y xno-skills@4.2.3 verify <nano_address> "<message>" <signature-hex> --json
+bunx -y xno-skills@4.3.0 verify <nano_address> "<message>" <signature-hex> --json
 ```
 
 **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.
@@ -511,7 +511,7 @@ PoW input:
 { "name": "wallet_change_rep", "arguments": { "wallet": "my-wallet", "representative": "nano_..." } }
 ```
 ```bash
-bunx -y xno-skills@4.2.3 change-rep --wallet "my-wallet" --representative "nano_..."
+bunx -y xno-skills@4.3.0 change-rep --wallet "my-wallet" --representative "nano_..."
 ```
 
 Full options: [change-rep](references/change-rep.md)