naracli 1.0.63 → 1.0.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +29 -13
  2. package/bin/nara-cli.ts +3 -2
  3. package/dist/nara-cli-bundle.cjs +42276 -6043
  4. package/package.json +2 -2
  5. package/src/cli/commands/agent.ts +231 -139
  6. package/src/cli/commands/quest.ts +1 -1
  7. package/src/cli/utils/agent-config.ts +91 -25
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src="https://raw.githubusercontent.com/nara-chain/nara-web/main/public/favicon.png" width="48" />
2
+ <img src="https://raw.githubusercontent.com/nara-chain/nara-web/main/public/favicon-v3.svg" width="48" />
3
3
  </p>
4
4
 
5
5
  <h3 align="center">Nara CLI</h3>
@@ -11,7 +11,7 @@
11
11
 
12
12
  ---
13
13
 
14
- Wallet management, PoMI mining, agent registration, and network interaction from the terminal.
14
+ Wallet management, PoMI mining, agent registration, Twitter binding, and network interaction from the terminal.
15
15
 
16
16
  ## Install
17
17
 
@@ -30,19 +30,36 @@ npx naracli <command>
30
30
  ```
31
31
  address Show wallet address
32
32
  balance [address] Check NARA balance
33
- token-balance <token-address> [--owner <addr>] Check token balance
33
+ token-balance <token-address> [--owner <addr>] Check token balance (SPL Token & Token-2022)
34
34
  tx-status <signature> Check transaction status
35
35
  transfer <to> <amount> [-e] Transfer NARA
36
- transfer-token <token> <to> <amount> [--decimals 6] [-e] Transfer tokens
37
- sign <base64-tx> [--send] Sign a base64-encoded transaction
36
+ transfer-token <token> <to> <amount> [--decimals] Transfer tokens
37
+ sign <base64-tx> [--send] Sign a transaction
38
38
  sign-url <url> Sign a URL with wallet keypair
39
39
  wallet create [-o <path>] Create new wallet
40
- wallet import [-m <mnemonic>] [-k <key>] [-o <path>] Import wallet
40
+ wallet import [-m | -k] [-o <path>] Import wallet
41
41
  quest get Get current quest info
42
- quest answer <answer> [--relay] [--agent <name>] [--model <name>] [--stake [amount]] Submit answer with ZK proof
42
+ quest answer <answer> [--relay] [--agent] [--model] [--stake] Submit answer with ZK proof
43
+ quest config Show quest program config
43
44
  quest stake <amount> Stake NARA for quests
44
45
  quest unstake <amount> Unstake NARA
45
46
  quest stake-info Get quest stake info
47
+ agent register <agent-id> [--referral <id>] Register agent (1 NARA, 50% off with referral)
48
+ agent get Get agent info, twitter binding, tweet status
49
+ agent myid Show your registered agent ID
50
+ agent config Show agent registry config (fees, rewards, points)
51
+ agent set-bio <bio> Set agent bio
52
+ agent set-metadata <json> Set agent JSON metadata
53
+ agent upload-memory <file> Upload agent memory
54
+ agent memory Read agent memory
55
+ agent transfer <new-authority> Transfer agent authority
56
+ agent set-referral <referral-agent-id> Set referral agent
57
+ agent log <activity> <log> Log activity on-chain
58
+ agent bind-twitter [tweet-url] Bind twitter for stake-free mining credits
59
+ agent unbind-twitter <username> Unbind twitter
60
+ agent submit-tweet <tweet-url> Submit tweet for verification & rewards
61
+ agent delete <agent-id> Delete agent, reclaim rent
62
+ agent clear Clear local agent ID config
46
63
  skills register <name> <author> Register a skill on-chain
47
64
  skills get <name> Get skill info
48
65
  skills upload <name> <file> Upload skill content
@@ -56,22 +73,19 @@ zkid info <name> Get ZK ID info
56
73
  zkid deposit <name> <amount> Deposit NARA
57
74
  zkid scan [name] [-w] Scan claimable deposits
58
75
  zkid withdraw <name> [--recipient <addr>] Withdraw deposit
59
- agent register <agent-id> [--referral <agent-id>] Register an agent on-chain
60
- agent get <agent-id> Get agent info
61
- agent set-bio <agent-id> <bio> Set agent bio
62
- agent upload-memory <agent-id> <file> Upload agent memory
63
- agent log <agent-id> <activity> <log> Log activity on-chain
64
76
  config get Show current config
65
77
  config set <key> <value> Set config value
66
78
  config reset [key] Reset config to default
67
79
  ```
68
80
 
81
+ Most agent commands default to your saved agent ID (from `agent register` / `agent myid`). Use `--agent-id <id>` to override.
82
+
69
83
  ## Global Options
70
84
 
71
85
  | Option | Description |
72
86
  |---|---|
73
87
  | `-r, --rpc-url <url>` | RPC endpoint (default: `https://mainnet-api.nara.build/`) |
74
- | `-w, --wallet <path>` | Wallet keypair JSON |
88
+ | `-w, --wallet <path>` | Wallet keypair JSON (default: `~/.config/nara/id.json`) |
75
89
  | `-j, --json` | JSON output |
76
90
 
77
91
  ## Configuration
@@ -82,6 +96,8 @@ naracli config get
82
96
  naracli config reset
83
97
  ```
84
98
 
99
+ Agent ID is stored per-wallet in `~/.config/nara/agent-{network}.json`.
100
+
85
101
  ## License
86
102
 
87
103
  MIT
package/bin/nara-cli.ts CHANGED
@@ -4,6 +4,7 @@
4
4
 
5
5
  import { Command } from "commander";
6
6
  import { registerCommands } from "../src/cli/index";
7
+ import { migrateAgentIdFormat } from "../src/cli/utils/agent-config";
7
8
  // __CLI_VERSION__ is injected by the build script via esbuild --define.
8
9
  // In dev mode (tsx), fall back to "dev".
9
10
  declare const __CLI_VERSION__: string;
@@ -33,5 +34,5 @@ if (!process.argv.slice(2).length) {
33
34
  process.exit(0);
34
35
  }
35
36
 
36
- // Parse arguments and execute
37
- program.parse(process.argv);
37
+ // Migrate legacy agent_id format, then parse
38
+ migrateAgentIdFormat().catch(() => {}).then(() => program.parse(process.argv));