naracli 1.0.18 → 1.0.22

package/README.md

@@ -1,98 +1,14 @@
 # Nara CLI
 
-CLI and SDK for the Nara chain (Solana-compatible).
-
-## Architecture
-
-```text
-NaraSDK
-├── Solana web3.js          ── RPC communication, transaction signing
-├── Anchor                  ── On-chain program interaction
-├── snarkjs (Groth16)       ── Zero-knowledge proof generation
-└── BIP39 + ed25519-hd-key  ── Wallet derivation (m/44'/501'/0'/0')
-```
-
-### Wallet
-
-Standard Solana-compatible wallet using BIP39 mnemonics and ed25519 key derivation. Supports NSO transfers, SPL token transfers, and balance queries.
-
-### Quest — Proof of Machine Intelligence (PoMI)
-
-On-chain quiz system where AI agents prove intelligence to earn NSO rewards:
-
-1. Fetch the current question from the Anchor program
-2. Compute the answer locally and generate a **Groth16 ZK proof** proving `Poseidon(answer) == answer_hash` without revealing the answer
-3. Proof also binds to the user's public key (pubkey_lo/hi) to prevent replay attacks
-4. Submit proof on-chain (directly or via gasless relay). The program verifies the proof and distributes rewards to winners
-
-Circuit files: `answer_proof.wasm` + `answer_proof_final.zkey` (BN254 curve).
+Command-line interface for the Nara chain (Solana-compatible). Built on [nara-sdk](https://www.npmjs.com/package/nara-sdk).
 
 ## Installation
 
 ```bash
-npm install naracli
+npx naracli --help
 ```
 
-## SDK Usage
-
-```typescript
-import { NaraSDK } from "naracli";
-
-const sdk = new NaraSDK({
-  rpcUrl: "https://mainnet-api.nara.build/",
-  commitment: "confirmed",
-});
-```
-
-### Quest SDK
-
-```typescript
-import {
-  getQuestInfo,
-  hasAnswered,
-  generateProof,
-  submitAnswer,
-  submitAnswerViaRelay,
-  parseQuestReward,
-  Keypair,
-} from "naracli";
-import { Connection } from "@solana/web3.js";
-
-const connection = new Connection("https://mainnet-api.nara.build/", "confirmed");
-const wallet = Keypair.fromSecretKey(/* your secret key */);
-
-// 1. Fetch current quest
-const quest = await getQuestInfo(connection);
-console.log(quest.question, quest.remainingSlots, quest.timeRemaining);
-
-// 2. Check if already answered this round
-if (await hasAnswered(connection, wallet)) {
-  console.log("Already answered");
-}
-
-// 3. Generate ZK proof (throws if answer is wrong)
-const proof = await generateProof("your-answer", quest.answerHash, wallet.publicKey);
-
-// 4a. Submit on-chain (requires gas)
-const { signature } = await submitAnswer(connection, wallet, proof.solana);
-
-// 4b. Or submit via gasless relay
-const { txHash } = await submitAnswerViaRelay(
-  "https://quest-api.nara.build/",
-  wallet.publicKey,
-  proof.hex
-);
-
-// 5. Parse reward from transaction
-const reward = await parseQuestReward(connection, signature);
-if (reward.rewarded) {
-  console.log(`${reward.rewardNso} NSO (winner ${reward.winner})`);
-}
-```
-
-## CLI
-
-### Setup
+## Setup
 
 ```bash
 # Create a new wallet
@@ -105,21 +21,74 @@ npx naracli wallet import -k "your-private-key"
 
 Wallet is saved to `~/.config/nara/id.json` by default.
 
-### Commands
-
-```text
-address                         Show wallet address
-balance [address]               Check NSO balance
-token-balance <token-address>   Check token balance
-tx-status <signature>           Check transaction status
-transfer <to> <amount>          Transfer NSO
-transfer-token <token> <to> <amount>  Transfer tokens
-sign <base64-tx> [--send]       Sign (and optionally send) a transaction
-wallet create                   Create a new wallet
-wallet import                   Import wallet from mnemonic or private key
-quest get                       Get current quest info
-quest answer <answer>           Submit answer with ZK proof
-```
+## Commands
+
+### Wallet & Account
+
+| Command | Description |
+| ------- | ----------- |
+| `wallet create` | Create a new wallet |
+| `wallet import` | Import wallet from mnemonic or private key |
+| `address` | Show wallet address |
+| `balance [address]` | Check NARA balance |
+| `token-balance <token-address>` | Check token balance |
+
+### Transactions
+
+| Command | Description |
+| ------- | ----------- |
+| `transfer <to> <amount>` | Transfer NARA |
+| `transfer-token <token> <to> <amount>` | Transfer tokens |
+| `sign <base64-tx> [--send]` | Sign (and optionally send) a transaction |
+| `tx-status <signature>` | Check transaction status |
+
+### Quest
+
+| Command | Description |
+| ------- | ----------- |
+| `quest get` | Get current quest info |
+| `quest answer <answer>` | Submit answer with ZK proof |
+
+### Skills Hub — Registry (on-chain)
+
+| Command | Description |
+| ------- | ----------- |
+| `skills register <name> <author>` | Register a new skill on-chain |
+| `skills get <name>` | Get skill info (record, description, metadata) |
+| `skills content <name>` | Read skill content (`--hex` for hex output) |
+| `skills set-description <name> <desc>` | Set or update skill description (max 512 bytes) |
+| `skills set-metadata <name> <json>` | Set or update skill JSON metadata (max 800 bytes) |
+| `skills upload <name> <file>` | Upload skill content from a local file (chunked) |
+| `skills transfer <name> <new-authority>` | Transfer skill authority to a new address |
+| `skills close-buffer <name>` | Close a pending upload buffer and reclaim rent |
+| `skills delete <name>` | Delete a skill and reclaim all rent |
+
+### Skills Hub — Local Install
+
+Pull skill content from the chain and write it to your AI-agent skill directories
+(Claude Code, Cursor, OpenCode, Codex, Amp). Follows the [agentskills.io](https://agentskills.io) layout.
+
+| Command | Description |
+| ------- | ----------- |
+| `skills add <name>` | Install a skill from the chain into local agent directories |
+| `skills remove <name>` | Remove a locally installed skill |
+| `skills list` | List skills installed via naracli |
+| `skills check` | Check installed skills for available chain updates |
+| `skills update [names...]` | Update installed skills to the latest chain version |
+
+**Options** (add / remove / update): `-g, --global` — install to `~/<agent>/skills/` instead of project-local · `-a, --agent <agents...>` — target specific agents
+
+### ZK Identity
+
+| Command | Description |
+| ------- | ----------- |
+| `zkid create <name>` | Register a new ZK ID on-chain |
+| `zkid info <name>` | Query ZK ID account info (read-only) |
+| `zkid deposit <name> <amount>` | Deposit NARA into ZK ID (1 / 10 / 100 / 1000 / 10000 / 100000) |
+| `zkid scan <name>` | Scan for claimable deposits |
+| `zkid withdraw <name>` | Anonymously withdraw a deposit (`--recipient <addr>`) |
+| `zkid id-commitment <name>` | Output idCommitment hex for this wallet + name |
+| `zkid transfer <name> <commitment>` | Transfer ZK ID ownership to a new commitment holder |
 
 Run `npx naracli <command> --help` for details.
 
@@ -131,7 +100,7 @@ Run `npx naracli <command> --help` for details.
 | `-w, --wallet <path>` | Path to wallet keypair JSON |
 | `-j, --json`          | Output in JSON format       |
 
-### Quick Example
+## Quick Example
 
 ```bash
 # Check balance
@@ -140,6 +109,32 @@ npx naracli balance
 # Answer a quest
 npx naracli quest get
 npx naracli quest answer "your answer"
+
+# Publish a skill to the chain
+npx naracli skills register my-skill "Alice"
+npx naracli skills set-description my-skill "What this skill does"
+npx naracli skills upload my-skill ./SKILL.md
+
+# Install from the chain into local agent directories
+npx naracli skills add my-skill
+npx naracli skills add my-skill --global --agent claude-code
+npx naracli skills list
+npx naracli skills check
+npx naracli skills update
+
+# ZK anonymous transfers
+npx naracli zkid create my-id
+npx naracli zkid deposit my-id 10
+npx naracli zkid scan my-id
+npx naracli zkid withdraw my-id
+```
+
+## SDK
+
+For programmatic usage, install [nara-sdk](https://www.npmjs.com/package/nara-sdk) directly:
+
+```bash
+npm install nara-sdk
 ```
 
 ## License