xno-skills 1.3.4 → 1.4.1

package/README.md

@@ -16,15 +16,30 @@ This repository includes built-in skills for AI agents (Claude Code, Cursor, etc
 npx skills add CasualSecurityInc/xno-skills
 ```
 
-Available skills:
-- `create-wallet`: Wallet creation/import guidance (BIP39 default; legacy supported; safe `--stdin` workflows).
-- `convert-units`: High-precision unit conversion reference.
-- `generate-qr`: Terminal-friendly Nano payment QR codes (address + optional amount).
-- `validate-address`: Address format and checksum verification guide.
-- `check-balance`: Check balance/pending via Nano node RPC.
-- `mcp-wallet`: Use `xno-mcp` as a private “wallet” custody blackbox (addresses only; no seed leakage).
-- `request-payment`: Request XNO from operator (payment request workflow with tracking, QR, receive, report).
-- `return-funds`: Return XNO to sender (source attribution, ambiguity guards, safe refund).
+Available skills (v1.4.0+):
+- `nano-check-balance`: Check balance/pending via Nano node RPC.
+- `nano-convert-units`: High-precision unit conversion reference.
+- `nano-create-wallet`: Wallet creation/import guidance (BIP39/Legacy support).
+- `nano-generate-qr`: Terminal-friendly Nano payment QR codes.
+- `nano-mcp-wallet`: Use `xno-mcp` as a private “wallet” custody blackbox.
+- `nano-request-payment`: Request XNO from operator (payment request workflow).
+- `nano-return-funds`: Return XNO to sender safely.
+- `nano-sign-message`: Sign off-chain messages (NOMS/ORIS-001).
+- `nano-validate-address`: Address format and checksum verification.
+- `nano-verify-message`: Verify off-chain message signatures.
+- `nano-block-lattice-expert`: Deep protocol wisdom and 2026 operational facts.
+
+### Migration (from < v1.4.0)
+
+If you have old skills installed without the `nano-` prefix, you should remove them and re-add the repo to avoid name collisions and "ghost" skills:
+
+```bash
+# 1. Remove old generic names
+npx skills remove -g check-balance convert-units create-wallet generate-qr mcp-wallet request-payment return-funds sign-message validate-address verify-message
+
+# 2. Add the new prefixed skills
+npx skills add -g CasualSecurityInc/xno-skills
+```
 
 ## MCP Server
 
@@ -37,27 +52,24 @@ To use it, add the following to your MCP client configuration:
   "mcpServers": {
     "xno": {
       "command": "npx",
-      "args": ["-y", "-p", "xno-skills@latest", "xno-mcp"]
+      "args": ["-y", "xno-skills@latest", "xno-mcp"]
     }
   }
 }
 ```
 
 Exposed tools:
-- `wallet_create` / `wallet_list` / `wallet_addresses`: Named “wallets” (custody inside MCP; return addresses only).
-- `wallet_balance` / `wallet_probe_balances`: Balance/pending checks for wallet accounts via RPC.
-- `wallet_receive` / `wallet_send`: Receive pending blocks and send funds (sign + work + `process` via RPC).
-- `config_get` / `config_set`: Store defaults (RPC URL, work URL, timeouts, default representative; optional wallet persistence).
-- `wallet_set_allowance` / `wallet_get_allowance`: Spending limits per wallet (per-tx cap, window budget, destination whitelist).
-- `wallet_history`: Persistent transaction log (sends, receives, linked payment requests).
-- `payment_request_create` / `payment_request_status` / `payment_request_receive` / `payment_request_list`: Payment request lifecycle.
-- `payment_request_refund`: Safe refund with source attribution and ambiguity guards.
-- `generate_qr`: Generate QR codes for Nano addresses/payment URIs.
-- `generate_wallet`: Generate a wallet (default: BIP39 derivation).
-- `derive_address`: Derive an address (supports `bip39` + `legacy`, with `auto` preference).
-- `probe_mnemonic`: Probe both derivations via RPC (helps resolve 24-word ambiguity).
-- `convert_units`: Converts between XNO and raw units.
-- `validate_address`: Validates address format and checksum.
+- `wallet_list`: List available wallets.
+- `wallet_balance`: Check balance/pending for a wallet account.
+- `wallet_receive` / `wallet_send`: Receive pending blocks or send funds.
+- `payment_request_create` / `payment_request_status` / `payment_request_receive` / `payment_request_list` / `payment_request_refund`: Full payment request lifecycle.
+- `wallet_history`: Persistent transaction log.
+- `config_get` / `config_set`: Manage server settings (RPC URL, representative, etc.).
+- `convert_units`: High-precision unit conversion.
+- `validate_address`: Offline address validation.
+- `rpc_account_balance`: Direct RPC balance check for any address.
+- `generate_qr`: Generate ASCII QR codes.
+- `sign_message` / `verify_message`: Sign and verify off-chain messages (NOMS).
 
 ## Installation
 

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -5,7 +5,7 @@ exports.version = exports.pkg = void 0;
 // Keep this in sync by running "npm run build" (prebuild hook).
 exports.pkg = {
     name: "xno-skills",
-    version: "1.3.4"
+    version: "1.4.1"
 };
 exports.version = exports.pkg.version;
 //# sourceMappingURL=version.js.map

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

@@ -1,27 +1,27 @@
 {
   "requests": [
     {
-      "id": "mofhy2ibb1b4dv",
+      "id": "mofinoatyd8xjb",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_1link1111111111111111111111111111111111111111111111111111111",
       "amountRaw": "10000000000000000000000000000",
       "reason": "explicit wallet test",
       "status": "pending",
-      "createdAt": "2026-04-26T08:18:41.843Z",
-      "updatedAt": "2026-04-26T08:18:41.843Z",
+      "createdAt": "2026-04-26T08:38:36.485Z",
+      "updatedAt": "2026-04-26T08:38:36.485Z",
       "receivedBlocks": []
     },
     {
-      "id": "mofhy2j23clmdw",
+      "id": "mofinobsiy729k",
       "owsWalletId": "A",
       "accountIndex": 0,
       "address": "nano_1link1111111111111111111111111111111111111111111111111111111",
       "amountRaw": "500000000000000000000000000000",
       "reason": "status check test",
       "status": "pending",
-      "createdAt": "2026-04-26T08:18:41.870Z",
-      "updatedAt": "2026-04-26T08:18:41.870Z",
+      "createdAt": "2026-04-26T08:38:36.520Z",
+      "updatedAt": "2026-04-26T08:38:36.520Z",
       "receivedBlocks": []
     }
   ]

package/dist/esm/version.d.ts

@@ -1,6 +1,6 @@
 export declare const pkg: {
     readonly name: "xno-skills";
-    readonly version: "1.3.4";
+    readonly version: "1.4.1";
 };
-export declare const version: "1.3.4";
+export declare const version: "1.4.1";
 //# 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: "1.3.4"
+    version: "1.4.1"
 };
 export const version = pkg.version;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xno-skills",
-  "version": "1.3.4",
+  "version": "1.4.1",
   "description": "XNO CLI - Interact with the Nano cryptocurrency",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/skills/{check-balance → nano-check-balance}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: check-balance
+name: nano-check-balance
 description: "Check a Nano account's balance and pending amount. You can check YOUR wallet's balance (via wallet_balance/wallet_probe_balances) or any address (via rpc_account_balance)."
 triggers:
   - check balance

package/skills/{convert-units → nano-convert-units}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: convert-units
+name: nano-convert-units
 description: Convert between XNO units (raw/xno/knano/mnano) with exact BigInt precision.
 triggers:
   - convert units

package/skills/{create-wallet → nano-create-wallet}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: create-wallet
+name: nano-create-wallet
 description: "Create or restore a Nano (XNO) wallet via Open Wallet Standard (OWS). For secure custody, rely on the unified OWS framework."
 triggers:
   - create wallet

package/skills/{generate-qr → nano-generate-qr}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: generate-qr
+name: nano-generate-qr
 description: Generate an ASCII QR code for a Nano address (optionally with an amount).
 triggers:
   - qr code

package/skills/{mcp-wallet → nano-mcp-wallet}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: mcp-wallet
+name: nano-mcp-wallet
 description: "You ARE a Nano (XNO) wallet operator via xno-mcp (bridging OWS). You can list wallets, check balances, send and receive XNO using OWS keys. Call wallet_list first."
 triggers:
   - purse

package/skills/{request-payment → nano-request-payment}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: request-payment
+name: nano-request-payment
 description: Request XNO from the operator. Creates a payment request, presents address/QR, watches for funds, receives them, and reports back.
 triggers:
   - request payment

package/skills/{return-funds → nano-return-funds}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: return-funds
+name: nano-return-funds
 description: Return XNO to the operator or original sender. Identifies source addresses, confirms before sending, handles ambiguity safely.
 triggers:
   - return funds

package/skills/{sign-message → nano-sign-message}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: sign-message
+name: nano-sign-message
 description: Sign an off-chain message (plain text) using a custodial wallet managed by xno-mcp. Following NOMS (Nano Off-chain Message Signature) / ORIS-001.
 triggers:
   - sign message

package/skills/{validate-address → nano-validate-address}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: validate-address
+name: nano-validate-address
 description: Validate Nano (XNO) addresses offline (format, checksum); no network.
 triggers:
   - validate address

package/skills/{verify-message → nano-verify-message}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: verify-message
+name: nano-verify-message
 description: Verify an off-chain message signature (NOMS / ORIS-001 standard) against a Nano address or public key.
 triggers:
   - verify message