xno-skills 1.5.15 → 2.0.2

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
 
-A TypeScript library, executable, and MCP server, for interacting with the Nano (XNO) cryptocurrency. Generate wallets, convert units, validate addresses, and more.
+A TypeScript library, CLI, and MCP server for Nano (XNO) actions. Pairs with Open Wallet Standard (OWS) for secure key custody — send, receive, change representatives, convert units, validate addresses, sign/verify messages, and more.
 
 ![xno-skills CLI preview](assets/xno-skills-cli.png)
 
@@ -16,7 +16,7 @@ This repository includes built-in skills for AI agents (Claude Code, Cursor, etc
 npx skills add CasualSecurityInc/xno-skills
 ```
 
-Available skills (v1.4.0+):
+Available skills (v2.0.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).
@@ -59,18 +59,25 @@ To use it, add the following to your MCP client configuration:
 ```
 
 Exposed tools:
-- `wallet_list`: List available wallets.
-- `wallet_balance`: Check balance/pending for a wallet account.
-- `wallet_receive` / `wallet_send`: Receive pending blocks or send funds.
+- `wallets`: List OWS wallets and their Nano addresses.
+- `address`: Get the Nano address for a wallet account index.
+- `balance`: Check confirmed balance and pending for a wallet account.
+- `pending`: List pending receivable blocks.
+- `receive`: Receive pending blocks (handles open/first-receive automatically).
+- `send`: Send XNO from a wallet account to a destination address.
+- `change`: Change the representative for a wallet account.
+- `submit_block`: Broadcast a pre-signed block hex (advanced/manual path).
+- `history`: Persistent transaction log.
 - `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.).
+- `config_get` / `config_set`: Manage server settings (RPC URL, representative, spending cap, 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).
 
+> **Compatibility aliases** (kept for one release): `wallet_list`, `wallet_balance`, `wallet_receive`, `wallet_send`, `wallet_history` map to the canonical tools above.
+
 ## Installation
 
 ```bash
@@ -163,26 +170,18 @@ npm install -g xno-skills
 npx xno-skills --help
 ```
 
-### Wallet Commands
+### Wallet Discovery
 
-Security note: avoid pasting mnemonics/seeds into chat logs. Prefer `--stdin` (or `--mnemonic-env`) for import/probing commands.
+Wallet lifecycle (create, import, rename, delete) is managed by [Open Wallet Standard (OWS)](https://github.com/open-wallet-standard/core). Use the `nano-create-wallet` skill or the OWS skill for that.
 
-#### Create a new wallet
+Once you have an OWS wallet, use these commands to interact with it on Nano:
 
 ```bash
-# Default: BIP39 derivation
-xno-skills wallet create
-
-# Choose legacy derivation (24-word “seed phrase” style)
-xno-skills wallet create --format legacy
+# List OWS wallets and their Nano addresses
+xno-skills wallets
 
-# Control BIP39 word count / passphrase / index
-xno-skills wallet create --words 12
-xno-skills wallet create --passphrase "optional passphrase"
-xno-skills wallet create --index 0
-
-# JSON output
-xno-skills wallet create --json
+# Get the Nano address for a specific wallet and account index
+xno-skills address --wallet my-wallet --index 0
 ```
 
 #### Restore from mnemonic

package/dist/cjs/base32.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Nano Base32 Encoding/Decoding
  *
@@ -8,9 +7,6 @@
  * Character set: 13456789abcdefghijkmnopqrstuwxyz (32 characters)
  * Note: 'x' IS included in the Nano charset (despite some docs saying otherwise)
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.base32Encode = base32Encode;
-exports.base32Decode = base32Decode;
 const CHARSET = '13456789abcdefghijkmnopqrstuwxyz';
 /**
  * Lookup table for decoding: character -> value (0-31)
@@ -36,7 +32,7 @@ for (let i = 0; i < CHARSET.length; i++) {
  * base32Encode(new Uint8Array([0xff])) // returns 'z'
  * ```
  */
-function base32Encode(bytes) {
+export function base32Encode(bytes) {
     if (bytes.length === 0) {
         return '';
     }
@@ -77,7 +73,7 @@ function base32Encode(bytes) {
  * base32Decode('z') // returns Uint8Array([0xff])
  * ```
  */
-function base32Decode(str) {
+export function base32Decode(str) {
     if (str.length === 0) {
         return new Uint8Array(0);
     }

package/dist/cjs/base32.js.map

@@ -1 +1 @@
-{"version":3,"file":"base32.js","sourceRoot":"","sources":["../../src/base32.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base32.js","sourceRoot":"","sources":["../../src/base32.ts"],"names":[],"mappings":"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"}

package/dist/cjs/blake2b.js

@@ -1,33 +1,28 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.blake2b256 = blake2b256;
-exports.blake2b512 = blake2b512;
-exports.blake2b256Hex = blake2b256Hex;
 // Blake2b hash functions using @noble/hashes
-const blake2b_js_1 = require("@noble/hashes/blake2b.js");
-const utils_js_1 = require("@noble/hashes/utils.js");
+import { blake2b } from '@noble/hashes/blake2b.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
 /**
  * Compute BLAKE2b-256 hash (32 bytes / 256 bits)
  * @param data - Input data as Uint8Array
  * @returns 32-byte hash
  */
-function blake2b256(data) {
-    return (0, blake2b_js_1.blake2b)(data, { dkLen: 32 });
+export function blake2b256(data) {
+    return blake2b(data, { dkLen: 32 });
 }
 /**
  * Compute BLAKE2b-512 hash (64 bytes / 512 bits)
  * @param data - Input data as Uint8Array
  * @returns 64-byte hash
  */
-function blake2b512(data) {
-    return (0, blake2b_js_1.blake2b)(data, { dkLen: 64 });
+export function blake2b512(data) {
+    return blake2b(data, { dkLen: 64 });
 }
 /**
  * Compute BLAKE2b-256 hash and return as hex string
  * @param data - Input data as Uint8Array
  * @returns Hex-encoded 32-byte hash (64 hex characters)
  */
-function blake2b256Hex(data) {
-    return (0, utils_js_1.bytesToHex)(blake2b256(data));
+export function blake2b256Hex(data) {
+    return bytesToHex(blake2b256(data));
 }
 //# sourceMappingURL=blake2b.js.map

package/dist/cjs/blake2b.js.map

@@ -1 +1 @@
-{"version":3,"file":"blake2b.js","sourceRoot":"","sources":["../../src/blake2b.ts"],"names":[],"mappings":";;AASA,gCAEC;AAOD,gCAEC;AAOD,sCAEC;AA7BD,6CAA6C;AAC7C,yDAAmD;AACnD,qDAAoD;AAEpD;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAgB;IACzC,OAAO,IAAA,oBAAO,EAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAgB;IACzC,OAAO,IAAA,oBAAO,EAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAgB;IAC5C,OAAO,IAAA,qBAAU,EAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"blake2b.js","sourceRoot":"","sources":["../../src/blake2b.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC"}