naracli 1.0.17 → 1.0.22

package/README.md

@@ -1,108 +1,14 @@
 # Nara CLI
 
-CLI and SDK for the Nara chain (Solana-compatible).
-
-## Architecture
-
-```text
-NaraSDK
-├── Solana web3.js          ── RPC communication, transaction signing
-├── Meteora DBC SDK         ── Dynamic Bonding Curve pools & swaps
-├── Meteora CP-AMM SDK      ── Post-graduation concentrated liquidity
-├── 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 (Answer-to-Earn with ZK Proofs)
-
-On-chain quiz system where correct answers 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).
-
-### Token Lifecycle (DBC)
-
-1. **Config** - Create bonding curve parameters (supply, initial/migration market cap, fees) via Meteora's `DynamicBondingCurveClient`
-2. **Pool** - Launch a token pool with the bonding curve config, optionally with an initial buy
-3. **Swap** - Buy/sell tokens on the bonding curve. Supports three modes: exact-in, partial-fill, exact-out
-4. **Migrate** - When curve reaches 100%, graduate the pool to Meteora DAMM V2 (Concentrated Position AMM). Requires two Position NFT keypairs for liquidity positions
+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})`);
-}
-```
-
-See [examples/](examples/) for complete SDK usage examples.
-
-## CLI
-
-### Setup
+## Setup
 
 ```bash
 # Create a new wallet
@@ -115,18 +21,76 @@ npx naracli wallet import -k "your-private-key"
 
 Wallet is saved to `~/.config/nara/id.json` by default.
 
-### Commands
-
-```text
-wallet    Wallet management (create, import, balance, transfer)
-config    Create bonding curve configurations
-pool      Create and query token pools
-swap      Buy / sell tokens, get quotes
-migrate   Check migration eligibility and launch to DAMM V2
-quest     On-chain quiz with ZK proof verification
-```
-
-Run `npx naracli <command> --help` for details on each command.
+## 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.
 
 ### Global Options
 
@@ -136,18 +100,41 @@ Run `npx naracli <command> --help` for details on each command.
 | `-w, --wallet <path>` | Path to wallet keypair JSON |
 | `-j, --json`          | Output in JSON format       |
 
-### Quick Example
+## Quick Example
 
 ```bash
 # Check balance
-npx naracli wallet balance
-
-# Buy tokens
-npx naracli swap buy <TOKEN_ADDRESS> 0.1
+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

package/bin/nara-cli.ts

@@ -4,7 +4,6 @@
 
 import { Command } from "commander";
 import { registerCommands } from "../src/cli/index";
-import { loadWallet } from "../src/cli/utils/wallet";
 import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);
@@ -25,25 +24,6 @@ program
   .option("-w, --wallet <path>", "Path to wallet keypair JSON file")
   .option("-j, --json", "Output in JSON format");
 
-// Top-level address shortcut
-program
-  .command("address")
-  .description("Show wallet address")
-  .action(async () => {
-    const opts = program.opts();
-    try {
-      const wallet = await loadWallet(opts.wallet);
-      if (opts.json) {
-        console.log(JSON.stringify({ address: wallet.publicKey.toBase58() }, null, 2));
-      } else {
-        console.log(wallet.publicKey.toBase58());
-      }
-    } catch (error: any) {
-      console.error(`Error: ${error.message}`);
-      process.exit(1);
-    }
-  });
-
 // Register all command modules
 registerCommands(program);